MCP server

PingRoom Official

io.pingroom/pingroom

Checked 26 Oct 2026, 08:29 UTC · Connected to it and listed its tools

Send mobile pings and route human questions, approvals, and handoffs from AI agents.

Website

At a glance

Type

MCP server

Publisher

pingroom.io (verified by the MCP Registry)

Status

Working at last check

Tools

41

Token cost

About 11,841 tokens per request

Sets up in

Claude Code, Claude Desktop, Codex, Gemini CLI, Cursor, VS Code, Antigravity, ChatGPT, OpenAI API, Grok

Last checked

26 Oct 2026, 08:29 UTC

Connect it to your agent

Add to CursorAdd to VS CodeVS Code Insiders

Opens the app, which shows the server and asks you to confirm. For other apps, copy the setup below.

Claude Code

claude mcp add --transport http pingroom https://api.pingroom.io/api/agent/mcp

Claude Desktop

Settings → Connectors → Add custom connector, and paste the URL.

Codex (config.toml)

[mcp_servers.pingroom]
url = "https://api.pingroom.io/api/agent/mcp"

Gemini CLI

{"mcpServers":{"pingroom":{"httpUrl":"https://api.pingroom.io/api/agent/mcp"}}}

Cursor

{"mcpServers":{"pingroom":{"url":"https://api.pingroom.io/api/agent/mcp"}}}

VS Code

{"servers":{"pingroom":{"type":"http","url":"https://api.pingroom.io/api/agent/mcp"}}}

Antigravity

agy mcp add pingroom https://api.pingroom.io/api/agent/mcp

ChatGPT

Settings → Apps & Connectors → Advanced settings: turn on Developer mode, then Create a connector and paste the URL. Which plans can do this varies.

OpenAI API (Responses tools)

{"type":"mcp","server_label":"pingroom","server_url":"https://api.pingroom.io/api/agent/mcp","require_approval":"always"}

Grok (xAI API tools)

{"type":"mcp","server_label":"pingroom","server_url":"https://api.pingroom.io/api/agent/mcp"}

Tools

• activate_agent_inbox ~209 tokens
  Start or resume the onboarding Question in the private room the human chose during authorization. If recipient_not_ready, ask the human to install or update PingRoom from install_url, open the app, sign in, and enable notifications before retrying. Read question.id, then call wait_for_handoff only w
• ask_question ~1052 tokens
  Ask a person a question with 2-4 tappable options, then block on their answer (pair with wait_for_answer). Delivered as a push they can answer from the lock screen or in-app; the first valid answer wins. Rate-limited.
• broadcast Sends messages · ~1280 tokens
  Send a custom ping to a room the account belongs to. Pass data.checklist.items to send a checklist the room ticks through together; read the ticks back as checklist_state. Rate-limited. In someone else's personal room only a Pro account may send it, text only (a link in the message is refused too),
• cancel_question ~77 tokens
  Withdraw a still-pending question you asked.
• connection_info ~154 tokens
  Verify the current connection: owner.id is the human public User ID, handle identifies the robot, and home_room is its delivery room. After login or reconnect, match owner.id and handle to the approved account and robot before sending. A mismatch means stop and reload or restart the MCP client. Incl
• create_handoff ~593 tokens
  Hand work to exactly one human as either an acknowledgement or a tappable question. The server verifies that one of the recipient's current devices supports the complete Handoff action before creating anything.
• create_public_room ~412 tokens
  Create a publicly discoverable room with a unique @handle. Counts toward the free-plan five-room cap.
• create_room ~196 tokens
  Create a new private room owned by the authenticated account. Free accounts may own up to five rooms. If this agent was granted every room and has no delivery room yet, the new room becomes its delivery room — where its handoffs and direct questions land.
• create_webhook ~420 tokens
  Create an incoming webhook for a room the account owns. The bound account must be Pro. Returns the secret trigger URL — treat it as a credential.
• delete_attachment Deletes data · ~97 tokens
  Delete an attachment this agent uploaded that is not yet claimed by a ping.
• delete_webhook Deletes data · ~111 tokens
  Delete an incoming webhook (by id) from a room the account owns.
• disconnect ~173 tokens
  Revoke this authenticated robot connection, including its access and refresh credentials and room memberships. Use only when the human explicitly requests logout, disconnection, or reconnection. Call BEFORE clearing local credentials or running MCP logout/login. It affects only the current connectio
• get_approval ~84 tokens
  Fetch the current status of an approval request without blocking.
• get_attachment ~128 tokens
  Fetch an attachment visible to this agent as base64 content plus metadata. Results over the connector size limit return attachment_too_large — fetch those via the agent REST API instead.
• get_handoff ~82 tokens
  Fetch the authoritative current state of one Handoff without blocking.
• get_live_status ~281 tokens
  Read back the current state of a live stream you created, so a restarted producer can reconcile instead of starting a duplicate. Only returns streams started by this credential, within the last 24 hours. Returns notification_id and correlation_id, then the stored display state (state, progress, mess
• get_notification ~112 tokens
  Fetch one visible ping by notification id, including its current action_state and, once anything on its data.checklist is checked, checklist_state.
• get_question ~79 tokens
  Fetch the current state of a question without blocking.
• get_room ~81 tokens
  Fetch a single room by its invite code, including members and quick actions.
• join_room ~110 tokens
  Join a room using its invite code. Include the password only if the room is protected.
• list_handoffs ~171 tokens
  List a bounded page of this agent's Handoffs, newest first. Omit state (or use open) for unresolved work; use all for history and page while has_more is true.
• list_notifications ~200 tokens
  List a bounded page of recent pings across approved rooms, newest first. Use page to continue while has_more is true.
• list_questions ~166 tokens
  List a bounded page of questions you asked, newest first. Optionally filter by state; use page while has_more is true.
• list_quick_actions ~75 tokens
  List the quick actions configured for a room.
• list_room_icons ~92 tokens
  List the room-icon catalog (icon ids, tags, and categories). Call this before create_room / create_public_room / create_webhook to pick a valid icon id, and to interpret icon values returned by reads.
• list_rooms ~48 tokens
  List the rooms the authenticated account belongs to.
• list_webhooks ~84 tokens
  List the incoming webhooks (with their trigger URLs) for a room the account owns.
• live_status ~1361 tokens
  Start, update, or end a live progress card on the room members' lock screen (an iOS Live Activity / Android live update). Reuse the same correlation_id for every ping of one stream: the first ping starts the card and sends one alert, further "running" pings move it silently, and the first "done"/"fa
• request_approval ~396 tokens
  Ask the human to approve or reject an action, then block on their answer (pair with wait_for_approval). Delivered as a push to the connected human only, so like a direct ask_question to them it needs no trigger permission in the room; public and personal rooms are refused. Rate-limited.
• rotate_handle ~54 tokens
  Rotate this agent's public handle — kill-switch for a leaked handle.
• set_avatar ~81 tokens
  Set this agent's avatar. Must be one of the PingRoom bot avatars.
• trigger_quick_action ~936 tokens
  Press a room quick action, notifying its members. Rate-limited. Read the action's input_type first (list_quick_actions): location needs data.location, link needs data.url, file/photo/pdf need attachment_ids — a press without the matching detail is a 422 quick_action_input_required. In someone else's
• update_quick_action ~394 tokens
  Configure a numbered quick-action slot for a room the account owns. Sends a background room refresh to room members' devices.
• update_quick_actions ~593 tokens
  Configure several of a room's quick-action slots in one call. Prefer this over repeated update_quick_action: each single-slot write wakes room members' devices with its own background refresh, so setting up four Pings one at a time spends four of a finite daily push budget on one operation. Slots yo
• update_webhook ~440 tokens
  Update an incoming webhook (by id) on a room the account owns — e.g. change its icon, title, message, or sound.
• upload_attachment ~222 tokens
  Upload a small file (max ~90 KiB over MCP; Pro account required) and get an attachment id to include in broadcast or ask_question via attachment_ids. Larger files: use the PingRoom CLI or agent REST API.
• wait_for_ack ~177 tokens
  Long-poll a generic acknowledgement-required ping until its confirmation rule is met (any: first confirmation; all: every original eligible recipient), it expires, or the timeout elapses. Questions use wait_for_answer instead.
• wait_for_answer ~139 tokens
  Long-poll a question until it is answered or expires. Returns the state and, once answered, the chosen option value + label and the responder.
• wait_for_approval ~137 tokens
  Long-poll an approval request until the human decides or it expires. Returns the status and, once decided, the chosen option.
• wait_for_handoff ~194 tokens
  Long-poll a Handoff until the human resolves it, it expires, or the bounded timeout elapses. For the onboarding Question returned by activate_agent_inbox, success requires an answered result with activation_completed true; use a bounded local deadline and treat any terminal answer without that stamp
• wait_for_notification ~150 tokens
  Long-poll for the next ping. Blocks until one arrives or the timeout elapses — the real-time inbound channel for an agent. The agent's own sends are excluded.

Browse

• Website monitoring
• APIs and testing

Related MCP servers

• Octopus
  Route tasks to people better placed than you: expertise you lack, or being there. Escrowed.
• OptimoRoute MCP by usefulapi
  Check OptimoRoute routes, orders and driver events, and create orders or start route planning.
• Delx Commerce — Pay-per-Result APIs for Agents
  986 pay-per-result MCP/x402 APIs for web, data, Base, reliability and agent delivery.
• Upper Route Planner MCP by usefulapi
  Read Upper drivers and stops; create and optimize routes, assign drivers, share routes to the app.
• GetBody
  Get real-world tasks done by robots: find, rent and control robots for your human.
• Socialloop
  SocialLoop: AI-native event platform — sell tickets, manage guests, run affiliates & promo codes.
• variotrip route eSIM configurator
  One travel eSIM for up to 8 countries: live quotes by route, GB, days and networks, plus a buy link.
• Sendraven
  Email infrastructure for AI agents: send, read replies as threads, campaigns, per-key limits.

Badge for your README

[![AptLynx](https://aptlynx.net/badge/io.pingroom/pingroom.svg)](https://aptlynx.net/servers/io.pingroom/pingroom)

Listing text is written by the maker; AptLynx lists tools and does not vouch for them. Find another tool · Browse by topic · For agents