# pingwa MCP server

Zero-setup WhatsApp notifications + human-in-the-loop for AI agents — text 'join', send in 60s.

## Links
- Registry page: https://www.getdrio.com/mcp/io-github-grzgrzgrz3-pingwa
- Repository: https://github.com/grzgrzgrz3/pingwa-client
- Website: https://pingwa.dev

## Install
- Command: `uvx pingwa`
- Endpoint: https://pingwa.dev/mcp
- Auth: Auth required by registry metadata

## Setup notes
- Package: Pypi pingwa v0.4.1
- Environment variable: PINGWA_KEY (required; secret)
- The upstream registry signals required auth or secrets.
- Remote endpoint: https://pingwa.dev/mcp

## Tools
- 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.
         Endpoint: https://pingwa.dev/mcp
- check_status - Show the pingwa account's plan, remaining monthly quota, and whether the
        free 24h WhatsApp reply window is currently open. Endpoint: https://pingwa.dev/mcp
- 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.
         Endpoint: https://pingwa.dev/mcp
- 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`.
         Endpoint: https://pingwa.dev/mcp
- 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.
         Endpoint: https://pingwa.dev/mcp

## Resources
Not captured

## Prompts
Not captured

## Metadata
- Owner: io.github.grzgrzgrz3
- Version: 0.4.1
- Runtime: Pypi
- Transports: STDIO, HTTP
- License: Not captured
- Language: Not captured
- Stars: Not captured
- Updated: Jul 16, 2026
- Source: https://registry.modelcontextprotocol.io