PingRoom
REMOTE · API.PINGROOM.IO
Send mobile pings and route human questions, approvals, and handoffs from AI agents.
Available components
Last scanned (13 hours ago)
Scores higher than 72% of remote servers
Reachable. Last reached 21 Nov 2026.
Category Communication
How this component scores in each security and reliability category. Every signal is checked automatically against the live server, and we only credit what we can confirm. How we score → Why this is hard to score →
Endpoint Security57
- The endpoint's TLS certificate is valid, in date, and uses a strong key. View diagnostics → Pass
- Authorisation check failed: no authorisation is required to call this server, and it exposes a tool marked destructive (disconnect). See how to fix → View diagnostics → Fail
- HTTPS is enforced; there's no plaintext access path. View diagnostics → Pass
- HSTS check failed: the Strict-Transport-Security header is absent. See how to fix → View diagnostics → Fail
- DNSSEC check failed: this domain isn't protected by DNSSEC. See how to fix → View diagnostics → Fail
Transport & Reachability100
- Verified streamable-http transport via a live MCP handshake. View diagnostics → Pass
Schema Quality & AI Usability71
- AI-judged instruction clarity (excellent).Pass
- Context-footprint check failed: tool/resource definitions use about 6584 tokens (~146/item across 45 items; 45 tools + 0 resources), over budget; trim descriptions and params. See how to fix → Fail
- Usage-examples check failed: none of the tools include examples. See how to fix → Fail
Stability & Change Management100
- No destabilizing schema changes in the last 30 days.Pass
Tool Coverage100
- 100% of tools have a non-trivial description (not blank, and not just the tool's name).Pass
- 99% of tool parameters carry a description.Partial
- Structured output schemas are declared (100% of tools); any adoption earns full credit.Pass
Tool Safety100
- No prompt-injection markers were found in the server instructions, tool names or descriptions we captured.Pass
- All 6 tool(s) whose name or description implies an irreversible operation declare an MCP destructiveHint annotation.Pass
- An AI judge read all 46 captured unit(s) of tool text and found none that tries to manipulate the model reading it.Pass
Capabilities100
- Implements a supported MCP spec version (2025-11-25); the latest is 2026-07-28.Pass
Checks we ran (13)
- TLS certificate
- Authorization
- HTTPS
- HSTS header
- DNSSEC
- Transport
- Schema quality
- Stability
- Tool coverage
- Injection markers
- Destructive annotations
- Judged manipulation
- MCP protocol
Does not apply to this hosted endpoint (2)
- Supply Chain SecurityScored on package channels only. This is a hosted endpoint, so there is nothing to install or inspect.
- Provenance & TransparencyScored on package channels only. This is a hosted endpoint, so there is nothing to install or inspect.
The score does not measure everything. What the score does not measure →
Every change we have recorded for this component, newest first. Security-relevant changes are always shown. ▲ marks a change for the better, ▼ a change for the worse; unmarked changes are neutral.
- 17 Nov 26 −2
- HSTS header: pass → fail ▼ security
- 14 Nov 26 0
- A breaking change shipped without a version bump: still 0.1.0 ▼ security
- Tool “replace_notification” was removed ▼ security
- Tool “withdraw_notification” was removed ▼ security
- “broadcast” reworded the description of “replace_key” cosmetic
- 12 Nov 26 0
- New tool “delete_metric”, which the server declares destructive security
- New tool “replace_notification”, which the server declares destructive security
- New tool “set_metric”, which the server declares destructive security
- New tool “withdraw_notification”, which the server declares destructive security
- Tool “get_live_status” rewrote its description, which is the text the model reads security
- Tool “live_claim” rewrote its description, which is the text the model reads security
- Schema quality: 133 → 150 ▼ functional
- New tool “list_metrics” functional
- “broadcast” added an optional parameter “replace_key” cosmetic
- “broadcast” added an optional parameter “tags” cosmetic
- “list_notifications” added an optional parameter “room_id” cosmetic
- “list_notifications” added an optional parameter “tag” cosmetic
- “live_status” added an optional parameter “tags” cosmetic
- “wait_for_notification” added an optional parameter “tag” cosmetic
- “broadcast” reworded the description of “data” cosmetic
- 11 Nov 26 0
- Stability: 0.97 → pass security
- 10 Nov 26 0
- Stability: pass → 0.97 functional
- 9 Nov 26 −1
- New tool “live_claim”, which the server declares destructive security
- Tool “get_live_status” rewrote its description, which is the text the model reads security
- “live_status” reworded the description of “title” cosmetic
- 8 Nov 26 +1
- Stability: 0.97 → pass security
- 7 Nov 26 0
- Stability: fail → 0.97 functional
Diagnostic detail from the automated scan of this channel: what the scanner observed at each step, so you can see exactly where a check passed or failed. It is informational only and never changes the trust score.
Captured 21 Nov 2026 · Probed https://api.pingroom.io/api/agent/mcp
TLS valid
Negotiated TLS 1.3 with TLS_AES_128_GCM_SHA256 .
| Subject | Issuer | Valid from | Valid until | Key | Signature | Serial |
|---|---|---|---|---|---|---|
| CN=pingroom.io | CN=WE1,O=Google Trust Services,C=US | 22 Oct 2026 | 20 Jan 2027 | ECDSA 256 | ECDSA-SHA256 | f5cdd6a53e004f6f1345b1ced03d37d7 |
| SANs: pingroom.io, *.pingroom.io | ||||||
| CN=WE1,O=Google Trust Services,C=US (CA) | CN=GTS Root R4,O=Google Trust Services LLC,C=US | 13 Dec 2023 | 20 Feb 2029 | ECDSA 256 | ECDSA-SHA384 | 7ff31977972c224a76155d13b6d685e3 |
| CN=GTS Root R4,O=Google Trust Services LLC,C=US (CA) | CN=GlobalSign Root CA,OU=Root CA,O=GlobalSign nv-sa,C=BE | 15 Nov 2023 | 28 Jan 2028 | ECDSA 384 | SHA256-RSA | 7fe530bf331343bedd821610493d8a1b |
Background: What to check on a remote MCP endpoint →
DNSSEC insecure
Validation of api.pingroom.io. — Not signed
| Zone | DS | Keys | Algorithms | Outcome |
|---|---|---|---|---|
| . | Trust anchor | 20326, 38696 | 8, 8 | Verified |
| io. | DS published | 38690 | 8 | Verified |
| pingroom.io. | No DS | Unsigned (proven) parent-signed NSEC/NSEC3 proves an unsigned delegation |
Authentication No authorisation required
The endpoint answered without asking for a token. Anyone who knows the URL can reach it.
| Result | No authorisation required |
|---|---|
| HTTP status | 200 |
Background: How OAuth 2.1 works in the 2026 MCP spec →
Transports 2 probes
| Transport | URL | Outcome | Status | Location |
|---|---|---|---|---|
| streamable-http | https://api.pingroom.io/api/agent/mcp | Verified | 200 | |
| http (plaintext) | http://api.pingroom.io/api/agent/mcp | HTTPS enforced | 301 | https://pingroom-agents.fly.dev/api/agent/mcp |
The tools this component advertises to a client, with an estimated token cost for each. Expand a tool to see its parameters and schema. The per-tool counts are indicative and are not scored directly; the schema's total context footprint is one signal in Schema Quality & AI Usability. A tool's description is untrusted text the model reads on every call, which is what makes this list a security surface and not just an inventory: how tool poisoning works →
activate_agent_inbox Activate Agent Inbox ~123
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.
Input schema present but exposes no named parameters.
| Name | Type | Req | Description |
|---|---|---|---|
| result | – | yes | Purpose-built PingRoom result with credential and account fields removed. |
No examples provided.
ask_question Ask Question ~303
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.
| Name | Type | Req | Description |
|---|---|---|---|
| attachment_ids | array | – | Ids of up to 4 uploaded attachments (see upload_attachment) to include. Uploading requires a Pro account. |
| context | string | – | Optional secondary line, e.g. a build number. |
| correlation_id | string | – | Your own id, echoed back unchanged on read. |
| data | object | – | Arbitrary structured context (max 25 keys / 8KB). Read surfaces return it after connector privacy filtering; do not put secrets in data. data.location is reserved for a shareable location, and data.c… |
| idempotency_key | string | – | Stable key so a retried call cannot create a second one. |
| invite_code | string | yes | Room invite code. |
| options | array | – | Answer options in display order. Omit for a default Approve/Deny. |
| prompt | string | yes | The question the person reads. |
| reply_to | string | – | Optional routing pointer, echoed back unchanged. |
| text_input | object | – | Invite a typed answer (on its own, or alongside options). max_length is capped at 60. |
| ttl | integer | – | Seconds the question stays open before it expires. |
| Name | Type | Req | Description |
|---|---|---|---|
| result | – | yes | Purpose-built PingRoom result with credential and account fields removed. |
No examples provided.
broadcast Broadcast Ping ~771
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.
| Name | Type | Req | Description |
|---|---|---|---|
| ack_mode | string | – | With requires_ack: any (default) resolves on the first confirmation; all waits for every original eligible recipient. Read action_state.confirmed_count and required_count for progress. |
| ack_timeout_seconds | integer | – | Optional acknowledgement deadline in seconds. |
| action_icon | string | – | Optional emoji shown with the ping. |
| action_number | integer | – | Optional quick-action slot to attribute the ping to. |
| attachment_ids | array | – | Ids of up to 4 uploaded attachments (see upload_attachment) to include. Uploading requires a Pro account. |
| correlation_id | string | – | Your own id, echoed back unchanged on read. |
| data | object | – | Arbitrary structured context (max 25 keys / 8KB). Read surfaces return it after connector privacy filtering; do not put secrets in data. data.location is reserved for a shareable location, data.check… |
| invite_code | string | yes | Room invite code. |
| is_urgent | boolean | – | Deliver time-sensitive so the ping breaks through Focus / Do Not Disturb and reaches members who muted the room or you (a block still wins). Independent of requires_ack: urgent affects delivery only… |
| message | string | yes | Ping body text (max 120 characters in private rooms, 160 in public rooms). |
| replace_key | string | – | Your own handle for "the ping I keep updating" (1 to 64 characters: letters, digits and . _ : -). Only on a server that has replacing turned on, which is when replace_notification is in your tool lis… |
| reply_to | string | – | Id of the ping this one answers (notification id or correlation id). |
| requires_ack | boolean | – | Keep this ping open until its confirmation rule is met, and show it as a lock-screen card with an Acknowledge button. Does not raise the interruption level on its own — combine with is_urgent for an… |
| tags | array | – | Up to 10 labels to file this ping under, so history can later be filtered by one (list_notifications and wait_for_notification take a tag). Each is 1 to 32 characters: lowercase letters, digits, "-"… |
| title | string | – | Optional headline. Defaults to the room name, which someone else's personal room always keeps. |
| Name | Type | Req | Description |
|---|---|---|---|
| result | object | yes | A privacy-minimized, chainable PingRoom notification result. |
No examples provided.
cancel_question Cancel Question ~27
Withdraw a still-pending question you asked.
| Name | Type | Req | Description |
|---|---|---|---|
| question_id | string | yes | Question id. |
| Name | Type | Req | Description |
|---|---|---|---|
| result | – | yes | Purpose-built PingRoom result with credential and account fields removed. |
No examples provided.
connection_info Connection Info ~89
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.
Input schema present but exposes no named parameters.
| Name | Type | Req | Description |
|---|---|---|---|
| result | object | yes | The authenticated robot and its owner public User ID, for account verification. |
No examples provided.
create_handoff Create Handoff ~223
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.
| Name | Type | Req | Description |
|---|---|---|---|
| audience | object | yes | – |
| correlation_id | string | – | Your own stable correlation id. |
| data | object | – | Structured context returned on read surfaces after connector privacy filtering. Do not put secrets in data. |
| expires_in | integer | – | Seconds before the handoff expires; the server clamps this to its safe range. |
| idempotency_key | string | – | Stable key for at-most-once creation across both Ack and Question kinds. |
| kind | string | yes | ack asks the human to acknowledge; question asks them to choose an option. |
| options | array | – | Required for question and forbidden for ack. Each item may be a label string or a structured option. |
| prompt | string | yes | The work/request shown to the human. |
| reply_to | string | – | Optional routing pointer. |
| urgency | string | – | Notification interruption level. Defaults to active. |
| Name | Type | Req | Description |
|---|---|---|---|
| result | – | yes | Purpose-built PingRoom result with credential and account fields removed. |
No examples provided.
create_public_room Create Public Room ~215
Create a publicly discoverable room with a unique @handle. Counts toward the free-plan five-room cap.
| Name | Type | Req | Description |
|---|---|---|---|
| category | string | – | Discovery category. |
| color | string | yes | Hex color, e.g. "#e33122". |
| description | string | – | Short room description shown in public discovery. |
| handle | string | yes | Globally unique @handle (vanity URL): lowercase letters, digits, underscores. |
| icon | string | yes | A v3 room-icon catalog id, e.g. "bell". Call list_room_icons to discover the valid ids. |
| location_latitude | number | – | Latitude in decimal degrees. Send all three location fields or none. |
| location_longitude | number | – | Longitude in decimal degrees. Send all three location fields or none. |
| location_name | string | – | Place name shown in nearby discovery. Send all three location fields or none. |
| name | string | yes | Room display name. |
| show_owner | boolean | – | Whether the owner is shown publicly. Defaults to true. |
| Name | Type | Req | Description |
|---|---|---|---|
| result | – | yes | Purpose-built PingRoom result with credential and account fields removed. |
No examples provided.
create_room Create Room ~116
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.
| Name | Type | Req | Description |
|---|---|---|---|
| color | string | yes | Hex color, e.g. "#e33122". |
| icon | string | yes | A v3 room-icon catalog id, e.g. "bell". Call list_room_icons to discover the valid ids. |
| name | string | yes | Room display name. |
| Name | Type | Req | Description |
|---|---|---|---|
| result | – | yes | Purpose-built PingRoom result with credential and account fields removed. |
No examples provided.
create_webhook Create Webhook ~246
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.
| Name | Type | Req | Description |
|---|---|---|---|
| action_number | integer|null | – | Quick-action slot whose label, sound, and acknowledgement preset fires use. Omit or pass null for an independent webhook with no Quick Ping preset. |
| color | string | – | Hex color, e.g. "#e33122". |
| cooldown_seconds | integer | – | Minimum seconds between fires. Defaults to 5. |
| enabled | boolean | – | Whether the webhook is active. Defaults to true. |
| icon | string | – | A v3 room-icon catalog id, e.g. "bell". Call list_room_icons to discover the valid ids. |
| invite_code | string | yes | Room invite code. |
| message | string | – | Optional default push body (max 120 characters in private rooms, 160 in public rooms). |
| name | string | yes | Webhook name (shown to the owner). |
| sound | string | – | Canonical sound id, e.g. "ting". Omit for the room default. |
| title | string | – | Optional push title used when the webhook fires. |
| Name | Type | Req | Description |
|---|---|---|---|
| result | object | yes | An incoming webhook. `webhook_url` embeds the secret — treat it as a credential. |
No examples provided.
delete_attachment Delete Attachment ~37
Delete an attachment this agent uploaded that is not yet claimed by a ping.
| Name | Type | Req | Description |
|---|---|---|---|
| attachment_id | string | yes | Attachment id returned by upload_attachment. |
| Name | Type | Req | Description |
|---|---|---|---|
| result | – | yes | Purpose-built PingRoom result with credential and account fields removed. |
No examples provided.
delete_metric Delete Metric ~77
Delete a metric (by key) from a room the account owns or administers.
| Name | Type | Req | Description |
|---|---|---|---|
| invite_code | string | yes | Room invite code. |
| key | string | yes | Metric key (from list_metrics): 1 to 40 characters, letters, digits, "-" and "_", starting with a letter or digit. Lowercased for you. |
| Name | Type | Req | Description |
|---|---|---|---|
| result | – | yes | Purpose-built PingRoom result with credential and account fields removed. |
No examples provided.
delete_webhook Delete Webhook ~55
Delete an incoming webhook (by id) from a room the account owns.
| Name | Type | Req | Description |
|---|---|---|---|
| invite_code | string | yes | Room invite code. |
| webhook_id | string | yes | Webhook id (from list_webhooks or create_webhook). |
| Name | Type | Req | Description |
|---|---|---|---|
| result | – | yes | Purpose-built PingRoom result with credential and account fields removed. |
No examples provided.
disconnect Disconnect ~92
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.
Input schema present but exposes no named parameters.
| Name | Type | Req | Description |
|---|---|---|---|
| result | object | yes | The authenticated robot and its owner public User ID, for account verification. |
No examples provided.
get_approval Get Approval ~31
Fetch the current status of an approval request without blocking.
| Name | Type | Req | Description |
|---|---|---|---|
| approval_id | string | yes | Approval request id. |
| Name | Type | Req | Description |
|---|---|---|---|
| result | – | yes | Purpose-built PingRoom result with credential and account fields removed. |
No examples provided.
get_attachment Get Attachment ~57
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.
| Name | Type | Req | Description |
|---|---|---|---|
| attachment_id | string | yes | Attachment id returned by upload_attachment. |
| Name | Type | Req | Description |
|---|---|---|---|
| result | – | yes | Purpose-built PingRoom result with credential and account fields removed. |
No examples provided.
get_handoff Get Handoff ~33
Fetch the authoritative current state of one Handoff without blocking.
| Name | Type | Req | Description |
|---|---|---|---|
| handoff_id | string | yes | Handoff id. |
| Name | Type | Req | Description |
|---|---|---|---|
| result | – | yes | Purpose-built PingRoom result with credential and account fields removed. |
No examples provided.
get_live_status Get Live Status ~203
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.
| Name | Type | Req | Description |
|---|---|---|---|
| correlation_id | string | yes | The stream key used when the stream was started. |
| invite_code | string | yes | Room invite code. |
| Name | Type | Req | Description |
|---|---|---|---|
| result | – | yes | Purpose-built PingRoom result with credential and account fields removed. |
No examples provided.
get_notification Get Notification ~47
Fetch one visible ping by notification id, including its current action_state and, once anything on its data.checklist is checked, checklist_state.
| Name | Type | Req | Description |
|---|---|---|---|
| notification_id | string | yes | Room notification id. |
| Name | Type | Req | Description |
|---|---|---|---|
| result | object | yes | A privacy-minimized, chainable PingRoom notification result. |
No examples provided.
get_question Get Question ~28
Fetch the current state of a question without blocking.
| Name | Type | Req | Description |
|---|---|---|---|
| question_id | string | yes | Question id. |
| Name | Type | Req | Description |
|---|---|---|---|
| result | – | yes | Purpose-built PingRoom result with credential and account fields removed. |
No examples provided.
get_room Get Room ~34
Fetch a single room by its invite code, including members and quick actions.
| Name | Type | Req | Description |
|---|---|---|---|
| invite_code | string | yes | Room invite code. |
| Name | Type | Req | Description |
|---|---|---|---|
| result | – | yes | Purpose-built PingRoom result with credential and account fields removed. |
No examples provided.
join_room Join Room ~51
Join a room using its invite code. Include the password only if the room is protected.
| Name | Type | Req | Description |
|---|---|---|---|
| invite_code | string | yes | Room invite code. |
| password | string | – | Only required for password-protected rooms. |
| Name | Type | Req | Description |
|---|---|---|---|
| result | – | yes | Purpose-built PingRoom result with credential and account fields removed. |
No examples provided.
list_handoffs List Handoffs ~99
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.
| Name | Type | Req | Description |
|---|---|---|---|
| limit | integer | – | Handoffs per page. Defaults to 10; maximum 25. |
| page | integer | – | Page number, newest first. |
| state | string | – | Filter to open Handoffs or include all states. |
| Name | Type | Req | Description |
|---|---|---|---|
| result | object | yes | – |
No examples provided.
list_metrics List Metrics ~69
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.
| Name | Type | Req | Description |
|---|---|---|---|
| invite_code | string | yes | Room invite code. |
| Name | Type | Req | Description |
|---|---|---|---|
| result | object | yes | – |
No examples provided.
list_notifications List Notifications ~165
List a bounded page of recent pings across approved rooms, newest first. Use page to continue while has_more is true.
| Name | Type | Req | Description |
|---|---|---|---|
| date | string | – | Only pings created on this calendar date, e.g. "2026-08-25". |
| limit | integer | – | Pings per page. Defaults to 10; maximum 25. |
| page | integer | – | Page number, newest first. |
| room_id | string | – | Only pings in this room (the room's id, as list_rooms and get_room return it). |
| tag | string | – | Only pings carrying this tag (see the tags field of broadcast and live_status). |
| type | string | – | Narrow to pings you received or pings you sent. Omit for both. |
| Name | Type | Req | Description |
|---|---|---|---|
| result | object | yes | – |
No examples provided.
list_questions List Questions ~80
List a bounded page of questions you asked, newest first. Optionally filter by state; use page while has_more is true.
| Name | Type | Req | Description |
|---|---|---|---|
| limit | integer | – | Questions per page. Defaults to 10; maximum 25. |
| page | integer | – | Page number, newest first. |
| state | string | – | Filter by state. Omit for all. |
| Name | Type | Req | Description |
|---|---|---|---|
| result | object | yes | – |
No examples provided.
list_quick_actions List Quick Actions ~30
List the quick actions configured for a room.
| Name | Type | Req | Description |
|---|---|---|---|
| invite_code | string | yes | Room invite code. |
| Name | Type | Req | Description |
|---|---|---|---|
| result | array | yes | – |
No examples provided.
list_room_icons List Room Icons ~52
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.
Input schema present but exposes no named parameters.
| Name | Type | Req | Description |
|---|---|---|---|
| result | – | yes | Purpose-built PingRoom result with credential and account fields removed. |
No examples provided.
list_rooms List Rooms ~17
List the rooms the authenticated account belongs to.
Input schema present but exposes no named parameters.
| Name | Type | Req | Description |
|---|---|---|---|
| result | array | yes | – |
No examples provided.
list_webhooks List Webhooks ~38
List the incoming webhooks (with their trigger URLs) for a room the account owns.
| Name | Type | Req | Description |
|---|---|---|---|
| invite_code | string | yes | Room invite code. |
| Name | Type | Req | Description |
|---|---|---|---|
| result | array | yes | – |
No examples provided.
live_claim Who's On It ~219
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.
| Name | Type | Req | Description |
|---|---|---|---|
| action | string | yes | What to do with the request. |
| invite_code | string | yes | Room invite code. |
| notification_id | string | yes | The request's notification id, from list_notifications or the live_status response. |
| Name | Type | Req | Description |
|---|---|---|---|
| result | – | yes | Purpose-built PingRoom result with credential and account fields removed. |
No examples provided.
live_status Publish Live Status ~452
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.
| Name | Type | Req | Description |
|---|---|---|---|
| ack_timeout_seconds | integer | – | Optional acknowledgement deadline in seconds. |
| action | integer | – | Quick-action slot to attribute the stream to (supplies the icon and sound). |
| correlation_id | string | yes | The stream key. Reuse it on every ping of the same stream. |
| data | object | – | Arbitrary structured context (max 25 keys / 8KB), returned on read surfaces after connector privacy filtering. Do not put secrets in data. |
| invite_code | string | yes | Room invite code. |
| live_status | object | yes | The live card's state. Only state is required. |
| requires_ack | boolean | – | Add an Acknowledge button; the first eligible member to tap resolves it for everyone. Does not raise the interruption level — set category "alert" for a time-sensitive start. |
| tags | array | – | Up to 10 labels to file this ping under, so history can later be filtered by one (list_notifications and wait_for_notification take a tag). Each is 1 to 32 characters: lowercase letters, digits, "-"… |
| title | string | – | Card title. Every template takes at most 40 characters and refuses a longer one; only the claim template takes up to 120 (its request text), which is why this schema allows 120. Defaults to the selec… |
| Name | Type | Req | Description |
|---|---|---|---|
| result | – | yes | Purpose-built PingRoom result with credential and account fields removed. |
No examples provided.
request_approval Request Approval ~208
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.
| Name | Type | Req | Description |
|---|---|---|---|
| correlation_id | string | – | Your own id, echoed back unchanged on read. |
| data | object | – | Arbitrary structured context, returned on reads after connector privacy filtering. Do not put secrets in data. |
| idempotency_key | string | – | Stable key so a retried call cannot create a second one. |
| invite_code | string | yes | Room invite code. |
| options | array | – | Answers to choose between. Defaults to ["approve","deny"]. |
| question | string | yes | What you want the human to decide on. |
| title | string | – | Optional short title for the request. |
| ttl | integer | – | Seconds the request stays open before it expires. |
| Name | Type | Req | Description |
|---|---|---|---|
| result | – | yes | Purpose-built PingRoom result with credential and account fields removed. |
No examples provided.
rotate_handle Rotate Agent Handle ~22
Rotate this agent's public handle — kill-switch for a leaked handle.
Input schema present but exposes no named parameters.
| Name | Type | Req | Description |
|---|---|---|---|
| result | – | yes | Purpose-built PingRoom result with credential and account fields removed. |
No examples provided.
set_avatar Set Agent Avatar ~43
Set this agent's avatar. Must be one of the PingRoom bot avatars.
| Name | Type | Req | Description |
|---|---|---|---|
| avatar_id | string | yes | Bot avatar id, e.g. "bots-3". |
| Name | Type | Req | Description |
|---|---|---|---|
| result | – | yes | Purpose-built PingRoom result with credential and account fields removed. |
No examples provided.
set_metric Set Metric ~330
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.
| Name | Type | Req | Description |
|---|---|---|---|
| format | string | – | How clients show the value: number, currency (needs unit: an ISO 4217 code), percent, unit (needs unit: free text such as ms) or text. Defaults to number or text by the value's type for a new metric. |
| invite_code | string | yes | Room invite code. |
| key | string | yes | Metric key (from list_metrics): 1 to 40 characters, letters, digits, "-" and "_", starting with a letter or digit. Lowercased for you. |
| label | string | – | Name shown beside the value (at most 24 characters). Defaults to the key for a new metric. |
| unit | string | – | An ISO 4217 code such as USD for the currency format, short free text such as ms for the unit format. Not allowed for the other formats. |
| value | number|string | yes | The value: a finite number with an absolute value of at most 1e15 for the number, currency, percent and unit formats, or a string of at most 24 characters for the text format. |
| Name | Type | Req | Description |
|---|---|---|---|
| result | object | yes | A room metric: a named value a widget shows. `value` is raw (a number for the numeric formats, a string for text, null until set); clients format it for the reader. |
No examples provided.
trigger_quick_action Trigger Quick Action ~519
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.
| Name | Type | Req | Description |
|---|---|---|---|
| ack_mode | string | – | Confirmation rule for this press: any (default) resolves on the first confirmation; all waits for every original eligible recipient. Applies only when this press requires acknowledgement. |
| action_number | integer | yes | Quick-action slot number (1–16). Slots 5–16 require the room owner to have Pro. |
| attachment_ids | array | – | Ids of up to 4 uploaded attachments (see upload_attachment). Required when the action's input_type is file, photo (jpg/png only) or pdf (pdf only); a mismatched type is a 422 quick_action_input_type. |
| data | object | – | The detail this press carries. data.location satisfies an action whose input_type is location; data.url satisfies link. Only these two keys are accepted on a trigger. |
| invite_code | string | yes | Room invite code. |
| is_urgent | boolean | – | Deliver this one press time-sensitive so it breaks through Focus / Do Not Disturb and reaches members who muted the room or you (a block still wins). Send-time only — the action's saved configuration… |
| quick_action_id | string | – | Optional id of the action as read from list_quick_actions. When the slot has since moved pages the press is refused with 409 quick_action_layout_changed instead of firing the wrong Ping. |
| requires_ack | boolean | – | Keep this one press open until an eligible recipient acknowledges it. Send-time only and elevating only: true adds the acknowledgement to an action that has none, false never disables the action's st… |
| trigger_source | string | – | Defaults to "manual". Only these two are client-settable — "webhook" and "system" are stamped server-side and are rejected here. "location" is room owner only: it sends the owner's Location Ping ("Ar… |
| Name | Type | Req | Description |
|---|---|---|---|
| result | object | yes | A privacy-minimized, chainable PingRoom notification result. |
No examples provided.
update_quick_action Update Quick Action ~233
Configure a numbered quick-action slot for a room the account owns. Sends a background room refresh to room members' devices.
| Name | Type | Req | Description |
|---|---|---|---|
| action_number | integer | yes | Quick-action slot number (1–16). Slots 5–16 require the room owner to have Pro. |
| icon | string | yes | Emoji or icon id. |
| input_type | string | – | Detail every press of this action must carry: none (default), location (data.location), link (data.url), file (any attachment), photo (jpg/png attachment) or pdf (pdf attachment). A press without it… |
| invite_code | string | yes | Room invite code. |
| label | string | yes | Button label. Must be sent, but may be empty ("") — a Ping can be named by its emoji alone, and clients render an untitled one as just the emoji. |
| requires_ack | boolean | – | Whether pings from this action remain open until one eligible recipient acknowledges them. |
| sound | string | – | Canonical sound id, e.g. "ting". Omit for the room default. |
| Name | Type | Req | Description |
|---|---|---|---|
| result | – | yes | Purpose-built PingRoom result with credential and account fields removed. |
No examples provided.
update_quick_actions Update Quick Actions ~172
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.
| Name | Type | Req | Description |
|---|---|---|---|
| actions | array | yes | Add new pages as complete groups of four in order (5–8, 9–12, 13–16); the room owner needs Pro. The slots to write. Each action_number must appear at most once. Slots omitted here keep their current… |
| invite_code | string | yes | Room invite code. |
| Name | Type | Req | Description |
|---|---|---|---|
| result | – | yes | Purpose-built PingRoom result with credential and account fields removed. |
No examples provided.
update_webhook Update Webhook ~257
Update an incoming webhook (by id) on a room the account owns — e.g. change its icon, title, message, or sound.
| Name | Type | Req | Description |
|---|---|---|---|
| action_number | integer|null | – | Quick-action slot whose label, sound, and acknowledgement preset fires use. Pass null to clear the preset and make the webhook independent. |
| color | string | – | Hex color, e.g. "#e33122". |
| cooldown_seconds | integer | – | Minimum seconds between fires. |
| enabled | boolean | – | Whether the webhook is active. |
| icon | string | – | A v3 room-icon catalog id, e.g. "bell". Call list_room_icons to discover the valid ids. |
| invite_code | string | yes | Room invite code. |
| message | string | – | Default push body (max 120 characters in private rooms, 160 in public rooms). |
| name | string | – | Webhook name (shown to the owner). |
| regenerate_secret | boolean | – | Rotate the secret trigger URL. |
| sound | string | – | Canonical sound id, e.g. "ting". |
| title | string | – | Push title used when the webhook fires. |
| webhook_id | string | yes | Webhook id (from list_webhooks or create_webhook). |
| Name | Type | Req | Description |
|---|---|---|---|
| result | object | yes | An incoming webhook. `webhook_url` embeds the secret — treat it as a credential. |
No examples provided.
upload_attachment Upload Attachment ~116
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.
| Name | Type | Req | Description |
|---|---|---|---|
| content_base64 | string | yes | Base64-encoded file bytes (standard alphabet, padding optional). |
| filename | string | yes | File name including extension, e.g. report.md. |
| mime_type | string | – | Optional MIME type, e.g. text/markdown. Defaults from the filename extension. |
| Name | Type | Req | Description |
|---|---|---|---|
| result | – | yes | Purpose-built PingRoom result with credential and account fields removed. |
No examples provided.
wait_for_ack Wait for Acknowledgement ~86
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.
| Name | Type | Req | Description |
|---|---|---|---|
| notification_id | string | yes | Room notification id. |
| timeout | integer | – | Seconds to hold the request open. Use 0 for an immediate authoritative state read. |
| Name | Type | Req | Description |
|---|---|---|---|
| result | object | yes | A privacy-minimized, chainable PingRoom notification result. |
No examples provided.
wait_for_answer Wait for Answer ~66
Long-poll a question until it is answered or expires. Returns the state and, once answered, the chosen option value + label and the responder.
| Name | Type | Req | Description |
|---|---|---|---|
| question_id | string | yes | Question id. |
| timeout | integer | – | Seconds to hold the request open (server-capped). |
| Name | Type | Req | Description |
|---|---|---|---|
| result | – | yes | Purpose-built PingRoom result with credential and account fields removed. |
No examples provided.
wait_for_approval Wait for Approval ~64
Long-poll an approval request until the human decides or it expires. Returns the status and, once decided, the chosen option.
| Name | Type | Req | Description |
|---|---|---|---|
| approval_id | string | yes | Approval request id. |
| timeout | integer | – | Seconds to hold the request open (server-capped). |
| Name | Type | Req | Description |
|---|---|---|---|
| result | – | yes | Purpose-built PingRoom result with credential and account fields removed. |
No examples provided.
wait_for_handoff Wait for Handoff ~103
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.
| Name | Type | Req | Description |
|---|---|---|---|
| handoff_id | string | yes | Handoff id. |
| timeout | integer | – | Seconds to hold the request open; use 0 for an immediate state read. |
| Name | Type | Req | Description |
|---|---|---|---|
| result | – | yes | Purpose-built PingRoom result with credential and account fields removed. |
No examples provided.
wait_for_notification Wait for Notification ~117
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.
| Name | Type | Req | Description |
|---|---|---|---|
| after | string | – | Cursor from the previous call; omit to get the current head. |
| tag | string | – | Only return pings carrying this tag; other pings are skipped, not returned. |
| timeout | integer | – | Seconds to hold the request open (server-capped). |
| Name | Type | Req | Description |
|---|---|---|---|
| result | object | yes | – |
No examples provided.
How do I install the PingRoom MCP server?
PingRoom is a hosted endpoint at https://api.pingroom.io/api/agent/mcp, so there is nothing to install locally. Ready-made configuration for Claude, Cursor, VS Code, Codex and 5 more is on this page, copied from each client's own documentation.
remote · api.pingroom.io
claude mcp add --transport http io-pingroom-pingroom 'https://api.pingroom.io/api/agent/mcp'
What is the PingRoom MCP server?
PingRoom is an MCP server listed in the public MCP registry as io.pingroom/pingroom. Send mobile pings and route human questions, approvals, and handoffs from AI agents. This page covers its hosted endpoint (https://api.pingroom.io/api/agent/mcp).
Is the PingRoom MCP server safe to use?
PingRoom scores 78 out of 100 on VerifyMCP. That is a record of what we were able to check automatically, not an endorsement. The category breakdown on this page shows every signal behind the number, including the ones we could not confirm.
What tools does the PingRoom MCP server expose?
PingRoom exposes 45 tools: connection_info, disconnect, list_rooms, list_quick_actions, trigger_quick_action, and 40 more. Their descriptions and schemas cost roughly 6,415 tokens of context every time the server is loaded.
Does the PingRoom MCP server require authentication?
No. We connected to PingRoom without credentials and it answered, so anything it exposes is reachable by anyone who knows the address.
Is the PingRoom MCP server still maintained?
PingRoom is still listed as active in the MCP registry. We last reached this channel on 21 November 2026. Those dates come from our own scans of the registry and the channel itself, not from anything the publisher announced.
What did VerifyMCP test on the PingRoom MCP server?
VerifyMCP ran 13 checks on PingRoom, covering TLS certificate, Authorization, HTTPS, HSTS header and 9 more. Supply Chain Security and Provenance & Transparency do not apply to a hosted endpoint, so they were not tested. The score does not measure everything, and the scoring documentation lists what it leaves out.