Skip to content
verify mcp Beta VerifyMCP is currently in beta. If you notice any issues, get in touch and we’ll put it right.

PingRoom

REMOTE · API.PINGROOM.IO

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

Available components

−2 this week 78 Trust /100

Last scanned (13 hours ago)

Scores higher than 72% of remote servers

Reachable. Last reached 21 Nov 2026.

Category Communication

Trust breakdown (7 categories)

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
Transport & Reachability100
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
What we tested

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 →

Changelog

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
Diagnostics

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
MCP tools · 45 exposed · ~6,415 tokens

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 →

Tool Tokens
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.

NameTypeReqDescription
result–yesPurpose-built PingRoom result with credential and account fields removed.

No examples provided.

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.

NameTypeReqDescription
attachment_idsarray–Ids of up to 4 uploaded attachments (see upload_attachment) to include. Uploading requires a Pro account.
contextstring–Optional secondary line, e.g. a build number.
correlation_idstring–Your own id, echoed back unchanged on read.
dataobject–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_keystring–Stable key so a retried call cannot create a second one.
invite_codestringyesRoom invite code.
optionsarray–Answer options in display order. Omit for a default Approve/Deny.
promptstringyesThe question the person reads.
reply_tostring–Optional routing pointer, echoed back unchanged.
text_inputobject–Invite a typed answer (on its own, or alongside options). max_length is capped at 60.
ttlinteger–Seconds the question stays open before it expires.
NameTypeReqDescription
result–yesPurpose-built PingRoom result with credential and account fields removed.

No examples provided.

broadcast ~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.

NameTypeReqDescription
ack_modestring–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_secondsinteger–Optional acknowledgement deadline in seconds.
action_iconstring–Optional emoji shown with the ping.
action_numberinteger–Optional quick-action slot to attribute the ping to.
attachment_idsarray–Ids of up to 4 uploaded attachments (see upload_attachment) to include. Uploading requires a Pro account.
correlation_idstring–Your own id, echoed back unchanged on read.
dataobject–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_codestringyesRoom invite code.
is_urgentboolean–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…
messagestringyesPing body text (max 120 characters in private rooms, 160 in public rooms).
replace_keystring–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_tostring–Id of the ping this one answers (notification id or correlation id).
requires_ackboolean–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…
tagsarray–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, "-"…
titlestring–Optional headline. Defaults to the room name, which someone else's personal room always keeps.
NameTypeReqDescription
resultobjectyesA privacy-minimized, chainable PingRoom notification result.

No examples provided.

cancel_question ~27

Withdraw a still-pending question you asked.

NameTypeReqDescription
question_idstringyesQuestion id.
NameTypeReqDescription
result–yesPurpose-built PingRoom result with credential and account fields removed.

No examples provided.

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.

NameTypeReqDescription
resultobjectyesThe authenticated robot and its owner public User ID, for account verification.

No examples provided.

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.

NameTypeReqDescription
audienceobjectyes–
correlation_idstring–Your own stable correlation id.
dataobject–Structured context returned on read surfaces after connector privacy filtering. Do not put secrets in data.
expires_ininteger–Seconds before the handoff expires; the server clamps this to its safe range.
idempotency_keystring–Stable key for at-most-once creation across both Ack and Question kinds.
kindstringyesack asks the human to acknowledge; question asks them to choose an option.
optionsarray–Required for question and forbidden for ack. Each item may be a label string or a structured option.
promptstringyesThe work/request shown to the human.
reply_tostring–Optional routing pointer.
urgencystring–Notification interruption level. Defaults to active.
NameTypeReqDescription
result–yesPurpose-built PingRoom result with credential and account fields removed.

No examples provided.

create_public_room ~215

Create a publicly discoverable room with a unique @handle. Counts toward the free-plan five-room cap.

NameTypeReqDescription
categorystring–Discovery category.
colorstringyesHex color, e.g. "#e33122".
descriptionstring–Short room description shown in public discovery.
handlestringyesGlobally unique @handle (vanity URL): lowercase letters, digits, underscores.
iconstringyesA v3 room-icon catalog id, e.g. "bell". Call list_room_icons to discover the valid ids.
location_latitudenumber–Latitude in decimal degrees. Send all three location fields or none.
location_longitudenumber–Longitude in decimal degrees. Send all three location fields or none.
location_namestring–Place name shown in nearby discovery. Send all three location fields or none.
namestringyesRoom display name.
show_ownerboolean–Whether the owner is shown publicly. Defaults to true.
NameTypeReqDescription
result–yesPurpose-built PingRoom result with credential and account fields removed.

No examples provided.

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.

NameTypeReqDescription
colorstringyesHex color, e.g. "#e33122".
iconstringyesA v3 room-icon catalog id, e.g. "bell". Call list_room_icons to discover the valid ids.
namestringyesRoom display name.
NameTypeReqDescription
result–yesPurpose-built PingRoom result with credential and account fields removed.

No examples provided.

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.

NameTypeReqDescription
action_numberinteger|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.
colorstring–Hex color, e.g. "#e33122".
cooldown_secondsinteger–Minimum seconds between fires. Defaults to 5.
enabledboolean–Whether the webhook is active. Defaults to true.
iconstring–A v3 room-icon catalog id, e.g. "bell". Call list_room_icons to discover the valid ids.
invite_codestringyesRoom invite code.
messagestring–Optional default push body (max 120 characters in private rooms, 160 in public rooms).
namestringyesWebhook name (shown to the owner).
soundstring–Canonical sound id, e.g. "ting". Omit for the room default.
titlestring–Optional push title used when the webhook fires.
NameTypeReqDescription
resultobjectyesAn incoming webhook. `webhook_url` embeds the secret — treat it as a credential.

No examples provided.

delete_attachment ~37

Delete an attachment this agent uploaded that is not yet claimed by a ping.

NameTypeReqDescription
attachment_idstringyesAttachment id returned by upload_attachment.
NameTypeReqDescription
result–yesPurpose-built PingRoom result with credential and account fields removed.

No examples provided.

delete_metric ~77

Delete a metric (by key) from a room the account owns or administers.

NameTypeReqDescription
invite_codestringyesRoom invite code.
keystringyesMetric key (from list_metrics): 1 to 40 characters, letters, digits, "-" and "_", starting with a letter or digit. Lowercased for you.
NameTypeReqDescription
result–yesPurpose-built PingRoom result with credential and account fields removed.

No examples provided.

delete_webhook ~55

Delete an incoming webhook (by id) from a room the account owns.

NameTypeReqDescription
invite_codestringyesRoom invite code.
webhook_idstringyesWebhook id (from list_webhooks or create_webhook).
NameTypeReqDescription
result–yesPurpose-built PingRoom result with credential and account fields removed.

No examples provided.

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.

NameTypeReqDescription
resultobjectyesThe authenticated robot and its owner public User ID, for account verification.

No examples provided.

get_approval ~31

Fetch the current status of an approval request without blocking.

NameTypeReqDescription
approval_idstringyesApproval request id.
NameTypeReqDescription
result–yesPurpose-built PingRoom result with credential and account fields removed.

No examples provided.

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.

NameTypeReqDescription
attachment_idstringyesAttachment id returned by upload_attachment.
NameTypeReqDescription
result–yesPurpose-built PingRoom result with credential and account fields removed.

No examples provided.

get_handoff ~33

Fetch the authoritative current state of one Handoff without blocking.

NameTypeReqDescription
handoff_idstringyesHandoff id.
NameTypeReqDescription
result–yesPurpose-built PingRoom result with credential and account fields removed.

No examples provided.

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.

NameTypeReqDescription
correlation_idstringyesThe stream key used when the stream was started.
invite_codestringyesRoom invite code.
NameTypeReqDescription
result–yesPurpose-built PingRoom result with credential and account fields removed.

No examples provided.

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.

NameTypeReqDescription
notification_idstringyesRoom notification id.
NameTypeReqDescription
resultobjectyesA privacy-minimized, chainable PingRoom notification result.

No examples provided.

get_question ~28

Fetch the current state of a question without blocking.

NameTypeReqDescription
question_idstringyesQuestion id.
NameTypeReqDescription
result–yesPurpose-built PingRoom result with credential and account fields removed.

No examples provided.

get_room ~34

Fetch a single room by its invite code, including members and quick actions.

NameTypeReqDescription
invite_codestringyesRoom invite code.
NameTypeReqDescription
result–yesPurpose-built PingRoom result with credential and account fields removed.

No examples provided.

join_room ~51

Join a room using its invite code. Include the password only if the room is protected.

NameTypeReqDescription
invite_codestringyesRoom invite code.
passwordstring–Only required for password-protected rooms.
NameTypeReqDescription
result–yesPurpose-built PingRoom result with credential and account fields removed.

No examples provided.

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.

NameTypeReqDescription
limitinteger–Handoffs per page. Defaults to 10; maximum 25.
pageinteger–Page number, newest first.
statestring–Filter to open Handoffs or include all states.
NameTypeReqDescription
resultobjectyes–

No examples provided.

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.

NameTypeReqDescription
invite_codestringyesRoom invite code.
NameTypeReqDescription
resultobjectyes–

No examples provided.

list_notifications ~165

List a bounded page of recent pings across approved rooms, newest first. Use page to continue while has_more is true.

NameTypeReqDescription
datestring–Only pings created on this calendar date, e.g. "2026-08-25".
limitinteger–Pings per page. Defaults to 10; maximum 25.
pageinteger–Page number, newest first.
room_idstring–Only pings in this room (the room's id, as list_rooms and get_room return it).
tagstring–Only pings carrying this tag (see the tags field of broadcast and live_status).
typestring–Narrow to pings you received or pings you sent. Omit for both.
NameTypeReqDescription
resultobjectyes–

No examples provided.

list_questions ~80

List a bounded page of questions you asked, newest first. Optionally filter by state; use page while has_more is true.

NameTypeReqDescription
limitinteger–Questions per page. Defaults to 10; maximum 25.
pageinteger–Page number, newest first.
statestring–Filter by state. Omit for all.
NameTypeReqDescription
resultobjectyes–

No examples provided.

list_quick_actions ~30

List the quick actions configured for a room.

NameTypeReqDescription
invite_codestringyesRoom invite code.
NameTypeReqDescription
resultarrayyes–

No examples provided.

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.

NameTypeReqDescription
result–yesPurpose-built PingRoom result with credential and account fields removed.

No examples provided.

list_rooms ~17

List the rooms the authenticated account belongs to.

Input schema present but exposes no named parameters.

NameTypeReqDescription
resultarrayyes–

No examples provided.

list_webhooks ~38

List the incoming webhooks (with their trigger URLs) for a room the account owns.

NameTypeReqDescription
invite_codestringyesRoom invite code.
NameTypeReqDescription
resultarrayyes–

No examples provided.

live_claim ~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.

NameTypeReqDescription
actionstringyesWhat to do with the request.
invite_codestringyesRoom invite code.
notification_idstringyesThe request's notification id, from list_notifications or the live_status response.
NameTypeReqDescription
result–yesPurpose-built PingRoom result with credential and account fields removed.

No examples provided.

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.

NameTypeReqDescription
ack_timeout_secondsinteger–Optional acknowledgement deadline in seconds.
actioninteger–Quick-action slot to attribute the stream to (supplies the icon and sound).
correlation_idstringyesThe stream key. Reuse it on every ping of the same stream.
dataobject–Arbitrary structured context (max 25 keys / 8KB), returned on read surfaces after connector privacy filtering. Do not put secrets in data.
invite_codestringyesRoom invite code.
live_statusobjectyesThe live card's state. Only state is required.
requires_ackboolean–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.
tagsarray–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, "-"…
titlestring–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…
NameTypeReqDescription
result–yesPurpose-built PingRoom result with credential and account fields removed.

No examples provided.

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.

NameTypeReqDescription
correlation_idstring–Your own id, echoed back unchanged on read.
dataobject–Arbitrary structured context, returned on reads after connector privacy filtering. Do not put secrets in data.
idempotency_keystring–Stable key so a retried call cannot create a second one.
invite_codestringyesRoom invite code.
optionsarray–Answers to choose between. Defaults to ["approve","deny"].
questionstringyesWhat you want the human to decide on.
titlestring–Optional short title for the request.
ttlinteger–Seconds the request stays open before it expires.
NameTypeReqDescription
result–yesPurpose-built PingRoom result with credential and account fields removed.

No examples provided.

rotate_handle ~22

Rotate this agent's public handle — kill-switch for a leaked handle.

Input schema present but exposes no named parameters.

NameTypeReqDescription
result–yesPurpose-built PingRoom result with credential and account fields removed.

No examples provided.

set_avatar ~43

Set this agent's avatar. Must be one of the PingRoom bot avatars.

NameTypeReqDescription
avatar_idstringyesBot avatar id, e.g. "bots-3".
NameTypeReqDescription
result–yesPurpose-built PingRoom result with credential and account fields removed.

No examples provided.

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.

NameTypeReqDescription
formatstring–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_codestringyesRoom invite code.
keystringyesMetric key (from list_metrics): 1 to 40 characters, letters, digits, "-" and "_", starting with a letter or digit. Lowercased for you.
labelstring–Name shown beside the value (at most 24 characters). Defaults to the key for a new metric.
unitstring–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.
valuenumber|stringyesThe 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.
NameTypeReqDescription
resultobjectyesA 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 ~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.

NameTypeReqDescription
ack_modestring–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_numberintegeryesQuick-action slot number (1–16). Slots 5–16 require the room owner to have Pro.
attachment_idsarray–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.
dataobject–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_codestringyesRoom invite code.
is_urgentboolean–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_idstring–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_ackboolean–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_sourcestring–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…
NameTypeReqDescription
resultobjectyesA privacy-minimized, chainable PingRoom notification result.

No examples provided.

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.

NameTypeReqDescription
action_numberintegeryesQuick-action slot number (1–16). Slots 5–16 require the room owner to have Pro.
iconstringyesEmoji or icon id.
input_typestring–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_codestringyesRoom invite code.
labelstringyesButton 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_ackboolean–Whether pings from this action remain open until one eligible recipient acknowledges them.
soundstring–Canonical sound id, e.g. "ting". Omit for the room default.
NameTypeReqDescription
result–yesPurpose-built PingRoom result with credential and account fields removed.

No examples provided.

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.

NameTypeReqDescription
actionsarrayyesAdd 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_codestringyesRoom invite code.
NameTypeReqDescription
result–yesPurpose-built PingRoom result with credential and account fields removed.

No examples provided.

update_webhook ~257

Update an incoming webhook (by id) on a room the account owns — e.g. change its icon, title, message, or sound.

NameTypeReqDescription
action_numberinteger|null–Quick-action slot whose label, sound, and acknowledgement preset fires use. Pass null to clear the preset and make the webhook independent.
colorstring–Hex color, e.g. "#e33122".
cooldown_secondsinteger–Minimum seconds between fires.
enabledboolean–Whether the webhook is active.
iconstring–A v3 room-icon catalog id, e.g. "bell". Call list_room_icons to discover the valid ids.
invite_codestringyesRoom invite code.
messagestring–Default push body (max 120 characters in private rooms, 160 in public rooms).
namestring–Webhook name (shown to the owner).
regenerate_secretboolean–Rotate the secret trigger URL.
soundstring–Canonical sound id, e.g. "ting".
titlestring–Push title used when the webhook fires.
webhook_idstringyesWebhook id (from list_webhooks or create_webhook).
NameTypeReqDescription
resultobjectyesAn incoming webhook. `webhook_url` embeds the secret — treat it as a credential.

No examples provided.

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.

NameTypeReqDescription
content_base64stringyesBase64-encoded file bytes (standard alphabet, padding optional).
filenamestringyesFile name including extension, e.g. report.md.
mime_typestring–Optional MIME type, e.g. text/markdown. Defaults from the filename extension.
NameTypeReqDescription
result–yesPurpose-built PingRoom result with credential and account fields removed.

No examples provided.

wait_for_ack ~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.

NameTypeReqDescription
notification_idstringyesRoom notification id.
timeoutinteger–Seconds to hold the request open. Use 0 for an immediate authoritative state read.
NameTypeReqDescription
resultobjectyesA privacy-minimized, chainable PingRoom notification result.

No examples provided.

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.

NameTypeReqDescription
question_idstringyesQuestion id.
timeoutinteger–Seconds to hold the request open (server-capped).
NameTypeReqDescription
result–yesPurpose-built PingRoom result with credential and account fields removed.

No examples provided.

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.

NameTypeReqDescription
approval_idstringyesApproval request id.
timeoutinteger–Seconds to hold the request open (server-capped).
NameTypeReqDescription
result–yesPurpose-built PingRoom result with credential and account fields removed.

No examples provided.

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.

NameTypeReqDescription
handoff_idstringyesHandoff id.
timeoutinteger–Seconds to hold the request open; use 0 for an immediate state read.
NameTypeReqDescription
result–yesPurpose-built PingRoom result with credential and account fields removed.

No examples provided.

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.

NameTypeReqDescription
afterstring–Cursor from the previous call; omit to get the current head.
tagstring–Only return pings carrying this tag; other pings are skipped, not returned.
timeoutinteger–Seconds to hold the request open (server-capped).
NameTypeReqDescription
resultobjectyes–

No examples provided.

Install

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

# add to Claude Code
claude mcp add --transport http io-pingroom-pingroom 'https://api.pingroom.io/api/agent/mcp'
Common questions

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.