protogrid

Search / io.github.grzgrzgrz3/pingwa

pingwa

R0· no sign-in

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

v0.4.1 · active · repository · website · descriptor JSON · versions

An agent can connect right now, no human step.Remote endpoint, no authentication, reachable on the last probe.
Quality83good
Trust90of 100
Uptime, 30 days97%
Latency p50639 ms

Connect

8 clients · secrets stay placeholders
{
  "mcpServers": {
    "pingwa": {
      "type": "http",
      "url": "https://pingwa.dev/mcp"
    }
  }
}
claude mcp add --transport http pingwa https://pingwa.dev/mcp
[mcp_servers.pingwa]
url = "https://pingwa.dev/mcp"
{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "pingwa": {
      "type": "remote",
      "url": "https://pingwa.dev/mcp",
      "enabled": true
    }
  }
}
{
  "mcpServers": {
    "pingwa": {
      "type": "http",
      "url": "https://pingwa.dev/mcp"
    }
  },
  "deeplink": "cursor://anysphere.cursor-deeplink/mcp/install?name=pingwa&config=eyJ0eXBlIjoiaHR0cCIsInVybCI6Imh0dHBzOi8vcGluZ3dhLmRldi9tY3AifQ%3D%3D"
}
{
  "servers": {
    "pingwa": {
      "type": "http",
      "url": "https://pingwa.dev/mcp"
    }
  }
}
{
  "mcpServers": {
    "pingwa": {
      "httpUrl": "https://pingwa.dev/mcp"
    }
  }
}
extensions:
  "pingwa":
    enabled: true
    name: "pingwa"
    type: streamable_http
    uri: "https://pingwa.dev/mcp"
    timeout: 300

Quality 83 / 100good

protocol75 · weight 25
  • warn
    protocol.modernnewest supported version is 2025-11-25; 2026-07-28 not supported, older versions are deprecated until 2027-07-28
  • n/a
    protocol.statelessonly applies to 2026-07-28 servers
  • pass
    protocol.transportstreamable HTTP
  • n/a
    protocol.list_ttlonly applies to 2026-07-28 servers
authorizationn/a · weight 15
  • n/a
    auth.prm, auth.as_metadata, auth.cimdno remote uses OAuth
  • n/a
    auth.secret_in_urlno templated URL
tool hygiene71 · weight 30
  • pass
    tools.descriptionsevery tool has a description
  • pass
    tools.description_lengthdescriptions are concise
  • pass
    tools.schemasevery tool has an object input schema
  • fail
    tools.annotationsno tool declares readOnlyHint or destructiveHint, so clients cannot tell safe calls from risky ones
  • fail
    tools.directory_hintsno tool declares all four of readOnlyHint, destructiveHint, idempotentHint and openWorldHint; missing: upgrade (readOnlyHint, destructiveHint, idempotentHint, openWorldHint); ask (readOnlyHint, destructiveHint, idempotentHint, openWorldHint); check_replies (readOnlyHint, destructiveHint, idempotentHint, openWorldHint); …
  • pass
    tools.token_costabout 662 tokens to load every tool
  • pass
    tools.api_dumptools are not a one-to-one API dump
stability100 · weight 15
  • pass
    stability.changesno tool changes in 30 days
  • pass
    stability.rug_pullno tool changed its meaning under the same name
dependencies100 · weight 15
  • pass
    deps.known_vulnsno known advisory in 32 resolved packages
  • pass
    deps.mcp_sdk_versionmcp 2.2.0, no known advisory
  • pass
    deps.resolvable[email protected] resolved: 32 packages

5 tools, about 662 tokens to load them all · tool set 33158acde15e · checked 2026-10-20 03:37 UTC

Tool changes

No tool definition changes recorded. A server's first observation is its baseline; later probes record what changes.

Checks run on what our credential-free, read-only probes observe; tools are never called and no code audit is performed. How it is computed.

Trust 90 / 100

provenance90
liveness99
freshness65
hygiene100

+repository +namespace-matches-repo +website +reachable +uptime-97% ~updated-95d-ago

Derived from observable signals (official registry feed and our own credential-free probes); no code audit performed. How it is computed.

Dependencies

[email protected] PyPI31 dependencies, resolved · MCP SDK mcp 2.2.0 · advisories checked 2026-10-19

No known advisory affects this dependency graph.

Dependency graphs from deps.dev; advisories from OSV.dev, including the GitHub Advisory Database and the PyPI Advisory Database; all CC BY 4.0. The graph is what a clean install of this version resolves today; nothing was installed or run. How it is checked.

Endpoints

remoteauthreachableuptime 30dp50protocollast ok
https://pingwa.dev/mcp streamable-httpnoneyes97%639 ms2025-11-252026-10-20
packageregistryversionruntimesecrets
pingwapypi0.4.1uvxPINGWA_KEY

Tools (5)

askAsk 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`.
check_repliesPull 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.
check_statusShow the pingwa account's plan, remaining monthly quota, and whether the free 24h WhatsApp reply window is currently open.
notifySend 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.
upgradeGet 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.

Schemas: list_tools.

Similar MCP servers

Official server.json
{
  "name": "io.github.grzgrzgrz3/pingwa",
  "title": "pingwa",
  "$schema": "https://static.modelcontextprotocol.io/schemas/2025-12-11/server.schema.json",
  "remotes": [
    {
      "url": "https://pingwa.dev/mcp",
      "type": "streamable-http"
    }
  ],
  "version": "0.4.1",
  "packages": [
    {
      "version": "0.4.1",
      "transport": {
        "type": "stdio"
      },
      "identifier": "pingwa",
      "runtimeHint": "uvx",
      "registryType": "pypi",
      "environmentVariables": [
        {
          "name": "PINGWA_KEY",
          "isSecret": true,
          "isRequired": true,
          "description": "pingwa API key (send 'join' on WhatsApp to the service number — see https://pingwa.dev)"
        }
      ]
    }
  ],
  "repository": {
    "url": "https://github.com/grzgrzgrz3/pingwa-client",
    "source": "github"
  },
  "websiteUrl": "https://pingwa.dev",
  "description": "Zero-setup WhatsApp notifications + human-in-the-loop for AI agents — text 'join', send in 60s."
}