MCP-Server

pingwa

io.github.grzgrzgrz3/pingwa
Kommunikation Öffentlich und erreichbar MCP 2025-11-25

Was dieses MCP kann

Sends WhatsApp notifications, asks humans for responses, checks replies and account status, and provides upgrade links.

ask
Ask the human a question on WhatsApp and BLOCK until they reply (or timeout). `text` is the question. `buttons` (optional, up to 3) render as tappable reply buttons; omit them to invite a free-text answer the human types on their phone — use this to let the human steer you mid-task. `timeout` is seconds to wait (max 90). Returns the human's reply (free text and/or the chosen option). On timeout, returns a note — the question was delivered and the answer is still retrievable via `check_replies`.
Eingabeschema
{'type': 'object', 'title': 'askArguments', 'required': ['text'], 'properties': {'text': {'type': 'string', 'title': 'Text'}, 'buttons': {'anyOf': [{'type': 'array', 'items': {'type': 'string'}}, {'type': 'null'}], 'title': 'Buttons', 'default': None}, 'timeout': {'type': 'integer', 'title': 'Timeout', 'default': 60}}}
Ausgabeschema
{'type': 'object', 'title': 'askOutput', 'required': ['result'], 'properties': {'result': {'type': 'string', 'title': 'Result'}}}
check_replies
Pull inbound WhatsApp messages the human sent to pingwa (out-of-band instructions, or late answers to an `ask`). `since` is a cursor from a previous call (pass it back to get only newer messages); `wait` long-polls up to that many seconds for something to arrive. Returns the messages and a new cursor.
Eingabeschema
{'type': 'object', 'title': 'check_repliesArguments', 'properties': {'wait': {'type': 'integer', 'title': 'Wait', 'default': 0}, 'since': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'title': 'Since', 'default': None}}}
Ausgabeschema
{'type': 'object', 'title': 'check_repliesOutput', 'required': ['result'], 'properties': {'result': {'type': 'string', 'title': 'Result'}}}
check_status
Show the pingwa account's plan, remaining monthly quota, and whether the free 24h WhatsApp reply window is currently open.
Eingabeschema
{'type': 'object', 'title': 'check_statusArguments', 'properties': {}}
Ausgabeschema
{'type': 'object', 'title': 'check_statusOutput', 'required': ['result'], 'properties': {'result': {'type': 'string', 'title': 'Result'}}}
notify
Send a WhatsApp notification to the account owner's own phone. `text` is the message (1-1024 chars). `image_url` (optional) is a public https image link — a screenshot, chart or diff — delivered as an image with `text` as the caption when the user's 24h window is open (otherwise text only). Returns a confirmation with the queued message id; raises an actionable error on quota/auth.
Eingabeschema
{'type': 'object', 'title': 'notifyArguments', 'required': ['text'], 'properties': {'text': {'type': 'string', 'title': 'Text'}, 'image_url': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'title': 'Image Url', 'default': None}}}
Ausgabeschema
{'type': 'object', 'title': 'notifyOutput', 'required': ['result'], 'properties': {'result': {'type': 'string', 'title': 'Result'}}}
upgrade
Get a link to upgrade the account to Pro (raises the monthly quota). Returns a Stripe Checkout URL for the human to open and pay — no pingwa password needed, the card is handled by Stripe. If the account is already Pro, returns a billing-portal URL to manage or cancel instead.
Eingabeschema
{'type': 'object', 'title': 'upgradeArguments', 'properties': {}}
Ausgabeschema
{'type': 'object', 'title': 'upgradeOutput', 'required': ['result'], 'properties': {'result': {'type': 'string', 'title': 'Result'}}}
Hinzugefügt
check_replies
17. September 2026 12:42
Hinzugefügt
ask
17. September 2026 12:42
Hinzugefügt
upgrade
17. September 2026 12:42
Hinzugefügt
check_status
17. September 2026 12:42
Hinzugefügt
notify
17. September 2026 12:42