PingRoom
Server Details
Send mobile pings and route human questions, approvals, and handoffs from AI agents.
- Status
- Healthy
- Uptime
- 100.0% over the last 24 hours
- Last Tested
- Transport
- Streamable HTTP · MCP 2025-11-25
- URL
- ChatGPT
- –
- Claude
- –
TDQS
Scored across 46 tools
Most tools target distinct resources, but several families overlap: ask_question, request_approval, and create_handoff (question variant) all push an interactive ask; update_quick_action vs update_quick_actions vs trigger_quick_action are close; broadcast, live_status, and trigger_quick_action all send pings. The verbose descriptions help resolve most of these, but an agent still faces real selection risk across the ~10 send/wait variants.
The bulk of the surface follows a clean verb_noun snake_case pattern (list_rooms, create_room, wait_for_answer, set_metric, delete_webhook). A handful deviate (broadcast, disconnect, connection_info, live_status, live_claim, activate_agent_inbox), but these read as intentional domain terms rather than chaotic mixing.
46 tools is heavy for a room-notification service, well above the 3-15 sweet spot. While many families (webhooks, metrics, quick actions, attachments) individually earn a few tools, the aggregate surface — especially the five wait_for_* and five get_* variants — feels inflated and burdens selection.
Coverage is broad: rooms (create/list/get/join), questions, approvals, handoffs, webhooks (full CRUD), metrics (set/list/delete), attachments (upload/get/delete), quick actions, and live status/claim are all present. Gaps remain — no delete_room, leave_room, or update_room — but these are minor workarounds for an agent.
Available Tools
46 toolsactivate_agent_inboxActivate Agent InboxAInspect
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 while state is pending and within a bounded local deadline. Success is answered with activation_completed true. Any other terminal result is incomplete: stop polling that attempt, then call activate_agent_inbox again for one numbered retry. The stamp requires native phone receipt before the human answer.
Inputs: no named parameters. Returns: result
ask_questionAsk QuestionAInspect
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.
Inputs: prompt (required), invite_code (required), ttl, data, +7 more. Returns: result
broadcastBroadcast PingAInspect
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), without title, is_urgent or requires_ack (all three are ignored there), and it counts toward the visitor's two-ping cap; otherwise use trigger_quick_action there.
Inputs: message (required), invite_code (required), data, tags, +11 more. Returns: result
cancel_questionCancel QuestionADestructiveIdempotentInspect
Withdraw a still-pending question you asked.
Inputs: question_id (required). Returns: result
connection_infoConnection InfoARead-onlyIdempotentInspect
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. Includes a credential-protected latest-pings feed and token-free install URL; never send credentials to the install URL.
Inputs: no named parameters. Returns: result
create_handoffCreate HandoffAInspect
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.
Inputs: kind (required), prompt (required), audience (required), data, +6 more. Returns: result
create_public_roomCreate Public RoomAInspect
Create a publicly discoverable room with a unique @handle. Counts toward the free-plan five-room cap.
Inputs: icon (required), name (required), color (required), handle (required), +6 more. Returns: result
create_roomCreate RoomAInspect
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.
Inputs: icon (required), name (required), color (required). Returns: result
create_webhookCreate WebhookAInspect
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.
Inputs: name (required), invite_code (required), icon, color, +6 more. Returns: result
delete_attachmentDelete AttachmentADestructiveIdempotentInspect
Delete an attachment this agent uploaded that is not yet claimed by a ping.
Inputs: attachment_id (required). Returns: result
delete_metricDelete MetricADestructiveIdempotentInspect
Delete a metric (by key) from a room the account owns or administers.
Inputs: key (required), invite_code (required). Returns: result
delete_webhookDelete WebhookADestructiveIdempotentInspect
Delete an incoming webhook (by id) from a room the account owns.
Inputs: webhook_id (required), invite_code (required). Returns: result
disconnectDisconnectADestructiveIdempotentInspect
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 connection and accepts no account or robot selector. After login, restart or reload the MCP client, then match connection_info owner.id and handle to the approved account and robot before sending.
Inputs: no named parameters. Returns: result
get_approvalGet ApprovalARead-onlyIdempotentInspect
Fetch the current status of an approval request without blocking.
Inputs: approval_id (required). Returns: result
get_attachmentGet AttachmentARead-onlyIdempotentInspect
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.
Inputs: attachment_id (required). Returns: result
get_guideGet GuideARead-onlyIdempotentInspect
Read how to use PingRoom well, as Markdown: the PingRoom skill for clients that have none installed. Call it once before your first send. topic "overview" (the default) covers which tool to reach for, verifying the connection, every kind of Ping, questions, approvals, handoffs, live progress, errors and tone; topic "tools" is the full per-tool reference. Returns content, the topics you can ask for, and source (the skill's repository).
Inputs: topic. Returns: result
get_handoffGet HandoffARead-onlyIdempotentInspect
Fetch the authoritative current state of one Handoff without blocking.
Inputs: handoff_id (required). Returns: result
get_live_statusGet Live StatusARead-onlyIdempotentInspect
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, message, category, template, accent_override, eta_at, deadline_at, duration_seconds, metrics, prompt, options, left, right, center, steps, current_step, started_at, value, value_label, delta, trend, stats, segments, current_segment), action_state, and updated_at; a claim request also returns its title and claim (status, by, at, late). Fields you never set come back as null rather than being omitted, so a matchup/metrics/countdown/question stream can be resumed without re-sending content.
Inputs: invite_code (required), correlation_id (required). Returns: result
get_notificationGet NotificationARead-onlyIdempotentInspect
Fetch one visible ping by notification id, including its current action_state and, once anything on its data.checklist is checked, checklist_state.
Inputs: notification_id (required). Returns: result
get_questionGet QuestionARead-onlyIdempotentInspect
Fetch the current state of a question without blocking.
Inputs: question_id (required). Returns: result
get_roomGet RoomARead-onlyIdempotentInspect
Fetch a single room by its invite code, including members and quick actions.
Inputs: invite_code (required). Returns: result
join_roomJoin RoomADestructiveIdempotentInspect
Join a room using its invite code. Include the password only if the room is protected.
Inputs: invite_code (required), password. Returns: result
list_handoffsList HandoffsARead-onlyIdempotentInspect
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.
Inputs: page, limit, state. Returns: result
list_metricsList MetricsARead-onlyIdempotentInspect
List the metrics kept in a room: named values (such as MRR or open tickets) a widget shows, each with its key, label, format, unit, current value and when the value last changed. Also returns the per-room limit.
Inputs: invite_code (required). Returns: result
list_notificationsList NotificationsARead-onlyIdempotentInspect
List a bounded page of recent pings across approved rooms, newest first. Use page to continue while has_more is true.
Inputs: tag, date, page, type, +2 more. Returns: result
list_questionsList QuestionsARead-onlyIdempotentInspect
List a bounded page of questions you asked, newest first. Optionally filter by state; use page while has_more is true.
Inputs: page, limit, state. Returns: result
list_quick_actionsList Quick ActionsARead-onlyIdempotentInspect
List the quick actions configured for a room.
Inputs: invite_code (required). Returns: result
list_room_iconsList Room IconsARead-onlyIdempotentInspect
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.
Inputs: no named parameters. Returns: result
list_roomsList RoomsARead-onlyIdempotentInspect
List the rooms the authenticated account belongs to.
Inputs: no named parameters. Returns: result
list_webhooksList WebhooksARead-onlyIdempotentInspect
List the incoming webhooks (with their trigger URLs) for a room the account owns.
Inputs: invite_code (required). Returns: result
live_claimWho's On ItADestructiveIdempotentInspect
Act on a "Who's on it?" request (a live_status stream with template "claim") as your human: "claim" takes an open request (anyone but its asker), "release" lets go of one you hold (it opens again for the room, or, once nobody can take it any more because its deadline has passed or it is four hours old without one, it ends as expired and its stream state is failed), "done" finishes it (its claimer, or its asker at any time) and "cancel" withdraws it (its asker, or a room owner or admin). Two claims at once have one winner: the other gets 409 claim_conflict with the current claim, naming who holds it. Repeating your own last action is a no-op that returns the same claim.
Inputs: action (required), invite_code (required), notification_id (required). Returns: result
live_statusPublish Live StatusADestructiveIdempotentInspect
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"/"failed" sends one completion alert and ends it. Free accounts get a small number of NEW streams per day; updates and the final ping of an open stream are never charged; a first ping that is already "done"/"failed" counts as a new stream.
Inputs: invite_code (required), live_status (required), correlation_id (required), data, +5 more. Returns: result
request_approvalRequest ApprovalAInspect
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.
Inputs: question (required), invite_code (required), ttl, data, +4 more. Returns: result
rotate_handleRotate Agent HandleADestructiveInspect
Rotate this agent's public handle — kill-switch for a leaked handle.
Inputs: no named parameters. Returns: result
set_avatarSet Agent AvatarADestructiveIdempotentInspect
Set this agent's avatar. Must be one of the PingRoom bot avatars.
Inputs: avatar_id (required). Returns: result
set_metricSet MetricADestructiveIdempotentInspect
Set a room metric's value, creating the metric when the key is new (a room holds at most 8). Sends no ping and no push. Needs a room the account owns or administers. A value equal to the stored one changes nothing and keeps its updated time. A new metric's label defaults to the key and its format to number (for a number) or text (for a string); numbers keep four decimal places. Values are raw: clients format them for the reader.
Inputs: key (required), value (required), invite_code (required), unit, +2 more. Returns: result
trigger_quick_actionTrigger Quick ActionAInspect
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 personal room is_urgent and requires_ack are ignored; only the owner's own setting on the action applies.
Inputs: invite_code (required), action_number (required), data, ack_mode, +5 more. Returns: result
update_quick_actionUpdate Quick ActionADestructiveIdempotentInspect
Configure a numbered quick-action slot for a room the account owns. Sends a background room refresh to room members' devices.
Inputs: icon (required), label (required), invite_code (required), action_number (required), +3 more. Returns: result
update_quick_actionsUpdate Quick ActionsADestructiveIdempotentInspect
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 you do not list are left exactly as they are, so this is also the right tool for editing a single Ping.
Inputs: actions (required), invite_code (required). Returns: result
update_webhookUpdate WebhookADestructiveInspect
Update an incoming webhook (by id) on a room the account owns — e.g. change its icon, title, message, or sound.
Inputs: webhook_id (required), invite_code (required), icon, name, +8 more. Returns: result
upload_attachmentUpload AttachmentAInspect
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.
Inputs: filename (required), content_base64 (required), mime_type. Returns: result
wait_for_ackWait for AcknowledgementARead-onlyIdempotentInspect
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.
Inputs: notification_id (required), timeout. Returns: result
wait_for_answerWait for AnswerARead-onlyIdempotentInspect
Long-poll a question until it is answered or expires. Returns the state and, once answered, the chosen option value + label and the responder.
Inputs: question_id (required), timeout. Returns: result
wait_for_approvalWait for ApprovalARead-onlyIdempotentInspect
Long-poll an approval request until the human decides or it expires. Returns the status and, once decided, the chosen option.
Inputs: approval_id (required), timeout. Returns: result
wait_for_handoffWait for HandoffAInspect
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 as incomplete.
Inputs: handoff_id (required), timeout. Returns: result
wait_for_notificationWait for NotificationARead-onlyIdempotentInspect
Long-poll for the next ping. Blocks until one arrives or the timeout elapses — the real-time inbound channel for an agent. Excludes everything your connected human sends (and your own sends); you receive other room members' Pings.
Inputs: tag, after, timeout. Returns: result
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
Related MCP Connectors
Poke your human for approvals and decisions during agent sessions — answered with one phone tap.
Give any AI agent a way to ask a person — for approval, a decision, an answer or a review.
Build and send email, SMS, and push straight from your AI agent.
Reach your own phone from an AI agent: notifications, approval questions, reminders, ring, files.
Related MCP Servers
- AlicenseNot gradedqualityBmaintenanceEnables AI agents to send prioritized notifications through SMS, Telegram, email, Slack, Discord, phone push, and webhooks, with routing rules, quiet hours, and per-agent limits.1MIT

tmgr-notifyofficial
AlicenseBqualityBmaintenanceEnables AI agents to reach users on their phone through push notifications, and to raise urgent, escalating alarms that fall back to a voice call until someone acknowledges. It also ships hooks that notify users automatically when Claude Code or Codex needs input or finishes a turn.39 npmMIT- AlicenseNot gradedqualityDmaintenanceHuman-in-the-loop approvals and notifications for AI agents via WhatsApp. Enables Cursor, Claude Code, and autonomous AI agents to reach users away from their computers.112 npmISC
- AlicenseNot gradedqualityCmaintenanceEnables AI agents to push a notification to a person's phone through channels such as Slack, ntfy, Pushover, Telegram, Discord, or email, carrying a link back to the conversation so the recipient can reply there. Runs either locally over stdio for a single operator or as a hosted multi-user service over HTTP with sign-in, per-user channel grants, and administrator-managed access.MIT
Glama MCP Gateway
Add one secure layer between your agents and this server.