Pingwire MCP server

Pingwire ships a dependency-free Model Context Protocol server so AI agents (Claude Desktop, Claude Code, and any MCP client) can create QR channels and send notifications on your behalf. It calls the Pingwire REST API with a Bearer key.

Tools

• create_qr_channel(name, description?, brand_color?) — create a subscribe-by-scan QR channel; returns the subscribe URL and QR image URLs.
• list_qr_channels() — list your QR channels with subscriber and scan counts.
• get_subscribe_qr(channel) — get the subscribe URL and QR PNG/SVG URLs for a channel.
• send_to_channel(channel, body, title?, priority?) — send a notification; it fans out as push to every active subscriber.

Configure your MCP client

{
  "mcpServers": {
    "pingwire": {
      "command": "php",
      "args": ["/home/pingwire.dev/public_html/mcp/pingwire-mcp.php"],
      "env": {
        "PINGWIRE_API_KEY": "pw_live_xxx",
        "PINGWIRE_URL": "https://pingwire.dev"
      }
    }
  }
}

Create an API key in Account → API keys. The server also reads ~/.pingwirerc as a fallback, like the CLI.

← Back to the API docs · QR Channels overview →