# PingRoom (remote · api.pingroom.io)

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

- Trust score: 78/100 (medium)
- Change this week: +6
- Registry status: active
- Liveness: live
- Owner verified: no
- Last scored: 2026-09-24

## Components

- remote · `api.pingroom.io`: 78/100 (this document), [markdown](https://verifymcp.io/servers/io-pingroom-pingroom/api-agent-mcp.md), [page](https://verifymcp.io/servers/io-pingroom-pingroom/api-agent-mcp)

## Channel facts

- Endpoint: `https://api.pingroom.io/api/agent/mcp`
- Transports: `streamable-http`
- Auth: `none`
- Version: `0.1.0`

## Trust breakdown

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. Scores are 0–100 per category. Scoring method: https://verifymcp.io/docs/scoring (what has changed: https://verifymcp.io/docs/scoring/changelog)

Scored 2026-09-24.

- **Endpoint Security**: 63/100
  - The endpoint's TLS certificate is valid, in date, and uses a strong key.
  - Authorisation check failed: no authorisation is required to call this server, and it exposes a tool marked destructive (disconnect).
  - HTTPS is enforced; there's no plaintext access path.
  - The HSTS (Strict-Transport-Security) header is present.
  - DNSSEC check failed: this domain isn't protected by DNSSEC.
- **Transport & Reachability**: 100/100
  - Verified streamable-http transport via a live MCP handshake.
- **Schema Quality & AI Usability**: 76/100
  - AI-judged instruction clarity (excellent).
  - Context-footprint check failed: tool/resource definitions use about 5148 tokens (~122/item across 42 items; 42 tools + 0 resources), over budget; trim descriptions and params.
  - Usage-examples check failed: none of the tools include examples.
- **Stability & Change Management**: 77/100
  - Stability observed for 23 of 30 days with no destabilising changes; credit accrues until the full window elapses.
- **Tool Coverage**: 100/100
  - 100% of tools have a non-trivial description (not blank, and not just the tool's name).
  - 99% of tool parameters carry a description.
  - Structured output schemas are declared (100% of tools); any adoption earns full credit.
- **Tool Safety**: 100/100
  - No prompt-injection markers were found in the server instructions, tool names or descriptions we captured.
  - All 5 tool(s) whose name or description implies an irreversible operation declare an MCP destructiveHint annotation.
  - An AI judge read all 43 captured unit(s) of tool text and found none that tries to manipulate the model reading it.
- **Capabilities**: 100/100
  - Implements a supported MCP spec version (2025-11-25); the latest is 2026-07-28.

## 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.

### Claude

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

### Cursor

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

### VS Code

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

### Codex

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

### opencode

```json
{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "io-pingroom-pingroom": {
      "type": "remote",
      "url": "https://api.pingroom.io/api/agent/mcp",
      "enabled": true
    }
  }
}
```

### OpenClaw

```bash
openclaw mcp add io-pingroom-pingroom --url 'https://api.pingroom.io/api/agent/mcp' --transport streamable-http
```

### Hermes

```yaml
mcp_servers:
  io-pingroom-pingroom:
    url: "https://api.pingroom.io/api/agent/mcp"
```

### Netclaw

```json
{
  "McpServers": {
    "io-pingroom-pingroom": {
      "Transport": "http",
      "Url": "https://api.pingroom.io/api/agent/mcp"
    }
  }
}
```

### Vellum

```bash
assistant mcp add io-pingroom-pingroom -t streamable-http -u 'https://api.pingroom.io/api/agent/mcp'
```

### Other

```json
{
  "mcpServers": {
    "io-pingroom-pingroom": {
      "type": "http",
      "url": "https://api.pingroom.io/api/agent/mcp"
    }
  }
}
```

The mcpServers block is a cross-client convention. Remote transports vary, so check your client's docs.

## Changelog

Every change recorded for this component, newest first. Days that predate change tracking, or that we cannot explain, say so: "we were watching and nothing happened" and "we were not watching" are different claims.

### 2026-09-24 (score 78, +1)

No change was recorded against any check on this day. Stability & Change Management went from 73 to 77. That category is still filling its 30-day observation window: 22 days of observed history at the previous scan, 23 at this one. The score rises as the window fills, whether or not the server changes.

### 2026-09-22 (score 77, 0)

- [security] Tool “trigger_quick_action” rewrote its description, which is the text the model reads
- [cosmetic] “create_public_room” added an optional parameter “location_latitude”
- [cosmetic] “create_public_room” added an optional parameter “location_longitude”
- [cosmetic] “create_public_room” added an optional parameter “location_name”
- [cosmetic] “trigger_quick_action” added an optional parameter “attachment_ids”
- [cosmetic] “trigger_quick_action” added an optional parameter “data”
- [cosmetic] “trigger_quick_action” added an optional parameter “quick_action_id”
- [cosmetic] “update_quick_action” added an optional parameter “input_type”

### 2026-09-21 (score 77, +1)

No change was recorded against any check on this day. Stability & Change Management went from 63 to 67. That category is still filling its 30-day observation window: 19 days of observed history at the previous scan, 20 at this one. The score rises as the window fills, whether or not the server changes.

### 2026-09-19 (score 76, +3)

- [security improvement] HSTS header: fail → pass

### 2026-09-18 (score 73, +1)

No change was recorded against any check on this day. Stability & Change Management went from 53 to 57. That category is still filling its 30-day observation window: 16 days of observed history at the previous scan, 17 at this one. The score rises as the window fills, whether or not the server changes.

### 2026-09-16 (score 72, +1)

- [cosmetic] “broadcast” reworded the description of “is_urgent”
- [cosmetic] “trigger_quick_action” reworded the description of “is_urgent”

### 2026-09-14 (score 71, +1)

No change was recorded against any check on this day. Stability & Change Management went from 40 to 43. That category is still filling its 30-day observation window: 12 days of observed history at the previous scan, 13 at this one. The score rises as the window fills, whether or not the server changes.

### 2026-09-12 (score 70, +1)

- [cosmetic] “trigger_quick_action” reworded the description of “action_number”
- [cosmetic] “update_quick_action” reworded the description of “action_number”
- [cosmetic] “update_quick_actions” reworded the description of “actions”

## MCP tools (42)

### `connection_info` (~89 tokens)

Connection Info

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.

Output parameters:

- `result` (object): The authenticated robot and its owner public User ID, for account verification.

### `disconnect` (~92 tokens)

Disconnect

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.

Output parameters:

- `result` (object): The authenticated robot and its owner public User ID, for account verification.

### `redeem_code` (~95 tokens)

Redeem Pro Code

Redeem a gifted Pro or promo code for the human account that connected this agent. Consumes a single-use code and grants Pro; no room or paid plan is required. Use only a code the user supplied for redemption. Existing eligibility and one-per-account limits apply. Do not retry a successful redemption.

Input parameters:

- `code` (string, required): The 12-letter/digit gift or promo code. Case-insensitive; surrounding whitespace is trimmed.

Output parameters:

- `result` (object)

### `list_rooms` (~17 tokens)

List Rooms

List the rooms the authenticated account belongs to.

Output parameters:

- `result` (array)

### `list_quick_actions` (~30 tokens)

List Quick Actions

List the quick actions configured for a room.

Input parameters:

- `invite_code` (string, required): Room invite code.

Output parameters:

- `result` (array)

### `trigger_quick_action` (~424 tokens)

Trigger Quick Action

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.

Input parameters:

- `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, required): 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, required): 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.

Output parameters:

- `result` (object): A privacy-minimized, chainable PingRoom notification result.

### `broadcast` (~413 tokens)

Broadcast Ping

Send a custom ping to a room the account belongs to. Rate-limited. Not available in personal rooms (use trigger_quick_action there).

Input parameters:

- `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, and data.u…
- `invite_code` (string, required): 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, required): Ping body text (max 120 characters in private rooms, 160 in public rooms).
- `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…
- `title` (string): Optional headline. Defaults to the room name.

Output parameters:

- `result` (object): A privacy-minimized, chainable PingRoom notification result.

### `live_status` (~292 tokens)

Publish Live Status

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 are never charged.

Input parameters:

- `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, required): 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, required): Room invite code.
- `live_status` (object, required): 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.
- `title` (string): Card title. Defaults to the selected quick action's label.

Output parameters:

- `result`: Purpose-built PingRoom result with credential and account fields removed.

### `get_live_status` (~163 tokens)

Get Live Status

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, metrics, prompt, options, left, right, center, steps, current_step), action_state, and updated_at. 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.

Input parameters:

- `correlation_id` (string, required): The stream key used when the stream was started.
- `invite_code` (string, required): Room invite code.

Output parameters:

- `result`: Purpose-built PingRoom result with credential and account fields removed.

### `list_room_icons` (~52 tokens)

List Room Icons

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.

Output parameters:

- `result`: Purpose-built PingRoom result with credential and account fields removed.

### `list_notifications` (~114 tokens)

List Notifications

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

Input parameters:

- `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.
- `type` (string): Narrow to pings you received or pings you sent. Omit for both.

Output parameters:

- `result` (object)

### `get_notification` (~33 tokens)

Get Notification

Fetch one visible ping by notification id, including its current action_state.

Input parameters:

- `notification_id` (string, required): Room notification id.

Output parameters:

- `result` (object): A privacy-minimized, chainable PingRoom notification result.

### `wait_for_notification` (~80 tokens)

Wait for Notification

Long-poll for the next ping. Blocks until one arrives or the timeout elapses — the real-time inbound channel for an agent. The agent's own sends are excluded.

Input parameters:

- `after` (string): Cursor from the previous call; omit to get the current head.
- `timeout` (integer): Seconds to hold the request open (server-capped).

Output parameters:

- `result` (object)

### `wait_for_ack` (~86 tokens)

Wait for Acknowledgement

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.

Input parameters:

- `notification_id` (string, required): Room notification id.
- `timeout` (integer): Seconds to hold the request open. Use 0 for an immediate authoritative state read.

Output parameters:

- `result` (object): A privacy-minimized, chainable PingRoom notification result.

### `request_approval` (~182 tokens)

Request Approval

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 user. Rate-limited.

Input parameters:

- `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, required): Room invite code.
- `options` (array): Answers to choose between. Defaults to ["approve","deny"].
- `question` (string, required): 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.

Output parameters:

- `result`: Purpose-built PingRoom result with credential and account fields removed.

### `wait_for_approval` (~64 tokens)

Wait for Approval

Long-poll an approval request until the human decides or it expires. Returns the status and, once decided, the chosen option.

Input parameters:

- `approval_id` (string, required): Approval request id.
- `timeout` (integer): Seconds to hold the request open (server-capped).

Output parameters:

- `result`: Purpose-built PingRoom result with credential and account fields removed.

### `get_approval` (~31 tokens)

Get Approval

Fetch the current status of an approval request without blocking.

Input parameters:

- `approval_id` (string, required): Approval request id.

Output parameters:

- `result`: Purpose-built PingRoom result with credential and account fields removed.

### `ask_question` (~295 tokens)

Ask Question

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.

Input parameters:

- `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.
- `idempotency_key` (string): Stable key so a retried call cannot create a second one.
- `invite_code` (string, required): Room invite code.
- `options` (array): Answer options in display order. Omit for a default Approve/Deny.
- `prompt` (string, required): 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.

Output parameters:

- `result`: Purpose-built PingRoom result with credential and account fields removed.

### `wait_for_answer` (~66 tokens)

Wait for Answer

Long-poll a question until it is answered or expires. Returns the state and, once answered, the chosen option value + label and the responder.

Input parameters:

- `question_id` (string, required): Question id.
- `timeout` (integer): Seconds to hold the request open (server-capped).

Output parameters:

- `result`: Purpose-built PingRoom result with credential and account fields removed.

### `get_question` (~28 tokens)

Get Question

Fetch the current state of a question without blocking.

Input parameters:

- `question_id` (string, required): Question id.

Output parameters:

- `result`: Purpose-built PingRoom result with credential and account fields removed.

### `list_questions` (~80 tokens)

List Questions

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

Input parameters:

- `limit` (integer): Questions per page. Defaults to 10; maximum 25.
- `page` (integer): Page number, newest first.
- `state` (string): Filter by state. Omit for all.

Output parameters:

- `result` (object)

### `cancel_question` (~27 tokens)

Cancel Question

Withdraw a still-pending question you asked.

Input parameters:

- `question_id` (string, required): Question id.

Output parameters:

- `result`: Purpose-built PingRoom result with credential and account fields removed.

### `activate_agent_inbox` (~123 tokens)

Activate Agent Inbox

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.

Output parameters:

- `result`: Purpose-built PingRoom result with credential and account fields removed.

### `create_handoff` (~223 tokens)

Create Handoff

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.

Input parameters:

- `audience` (object, required)
- `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, required): 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, required): The work/request shown to the human.
- `reply_to` (string): Optional routing pointer.
- `urgency` (string): Notification interruption level. Defaults to active.

Output parameters:

- `result`: Purpose-built PingRoom result with credential and account fields removed.

### `wait_for_handoff` (~103 tokens)

Wait for Handoff

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.

Input parameters:

- `handoff_id` (string, required): Handoff id.
- `timeout` (integer): Seconds to hold the request open; use 0 for an immediate state read.

Output parameters:

- `result`: Purpose-built PingRoom result with credential and account fields removed.

### `get_handoff` (~33 tokens)

Get Handoff

Fetch the authoritative current state of one Handoff without blocking.

Input parameters:

- `handoff_id` (string, required): Handoff id.

Output parameters:

- `result`: Purpose-built PingRoom result with credential and account fields removed.

### `list_handoffs` (~99 tokens)

List Handoffs

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.

Input parameters:

- `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.

Output parameters:

- `result` (object)

### `upload_attachment` (~116 tokens)

Upload Attachment

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.

Input parameters:

- `content_base64` (string, required): Base64-encoded file bytes (standard alphabet, padding optional).
- `filename` (string, required): File name including extension, e.g. report.md.
- `mime_type` (string): Optional MIME type, e.g. text/markdown. Defaults from the filename extension.

Output parameters:

- `result`: Purpose-built PingRoom result with credential and account fields removed.

### `get_attachment` (~57 tokens)

Get Attachment

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.

Input parameters:

- `attachment_id` (string, required): Attachment id returned by upload_attachment.

Output parameters:

- `result`: Purpose-built PingRoom result with credential and account fields removed.

### `delete_attachment` (~37 tokens)

Delete Attachment

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

Input parameters:

- `attachment_id` (string, required): Attachment id returned by upload_attachment.

Output parameters:

- `result`: Purpose-built PingRoom result with credential and account fields removed.

### `get_room` (~34 tokens)

Get Room

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

Input parameters:

- `invite_code` (string, required): Room invite code.

Output parameters:

- `result`: Purpose-built PingRoom result with credential and account fields removed.

### `create_room` (~116 tokens)

Create Room

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.

Input parameters:

- `color` (string, required): Hex color, e.g. "#e33122".
- `icon` (string, required): A v3 room-icon catalog id, e.g. "bell". Call list_room_icons to discover the valid ids.
- `name` (string, required): Room display name.

Output parameters:

- `result`: Purpose-built PingRoom result with credential and account fields removed.

### `create_public_room` (~215 tokens)

Create Public Room

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

Input parameters:

- `category` (string): Discovery category.
- `color` (string, required): Hex color, e.g. "#e33122".
- `description` (string): Short room description shown in public discovery.
- `handle` (string, required): Globally unique @handle (vanity URL): lowercase letters, digits, underscores.
- `icon` (string, required): 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, required): Room display name.
- `show_owner` (boolean): Whether the owner is shown publicly. Defaults to true.

Output parameters:

- `result`: Purpose-built PingRoom result with credential and account fields removed.

### `join_room` (~51 tokens)

Join Room

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

Input parameters:

- `invite_code` (string, required): Room invite code.
- `password` (string): Only required for password-protected rooms.

Output parameters:

- `result`: Purpose-built PingRoom result with credential and account fields removed.

### `list_webhooks` (~38 tokens)

List Webhooks

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

Input parameters:

- `invite_code` (string, required): Room invite code.

Output parameters:

- `result` (array)

### `create_webhook` (~230 tokens)

Create Webhook

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.

Input parameters:

- `action_number` (integer): Quick-action slot to attribute fires to. Auto-assigned if omitted.
- `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, required): Room invite code.
- `message` (string): Optional default push body (max 120 characters in private rooms, 160 in public rooms).
- `name` (string, required): 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.

Output parameters:

- `result` (object): An incoming webhook. `webhook_url` embeds the secret — treat it as a credential.

### `update_webhook` (~238 tokens)

Update Webhook

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

Input parameters:

- `action_number` (integer): Quick-action slot to attribute fires to.
- `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, required): 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, required): Webhook id (from list_webhooks or create_webhook).

Output parameters:

- `result` (object): An incoming webhook. `webhook_url` embeds the secret — treat it as a credential.

### `delete_webhook` (~55 tokens)

Delete Webhook

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

Input parameters:

- `invite_code` (string, required): Room invite code.
- `webhook_id` (string, required): Webhook id (from list_webhooks or create_webhook).

Output parameters:

- `result`: Purpose-built PingRoom result with credential and account fields removed.

### `update_quick_action` (~222 tokens)

Update Quick Action

Configure a numbered quick-action slot for a room the account owns.

Input parameters:

- `action_number` (integer, required): Quick-action slot number (1–16). Slots 5–16 require the room owner to have Pro.
- `icon` (string, required): 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, required): Room invite code.
- `label` (string, required): 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.

Output parameters:

- `result`: Purpose-built PingRoom result with credential and account fields removed.

### `update_quick_actions` (~171 tokens)

Update Quick Actions

Configure several of a room's quick-action slots in one call. Prefer this over repeated update_quick_action: each single-slot write wakes the owner's device 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.

Input parameters:

- `actions` (array, required): 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, required): Room invite code.

Output parameters:

- `result`: Purpose-built PingRoom result with credential and account fields removed.

### `set_avatar` (~43 tokens)

Set Agent Avatar

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

Input parameters:

- `avatar_id` (string, required): Bot avatar id, e.g. "bots-3".

Output parameters:

- `result`: Purpose-built PingRoom result with credential and account fields removed.

### `rotate_handle` (~22 tokens)

Rotate Agent Handle

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

Output parameters:

- `result`: Purpose-built PingRoom result with credential and account fields removed.

## Diagnostics

Captured diagnostic sections: TLS, DNSSEC, Authorisation, Transports. The full working is on the page: https://verifymcp.io/servers/io-pingroom-pingroom/api-agent-mcp#diagnostics

## Score history

- 2026-09-24: 78
- 2026-09-23: 77
- 2026-09-22: 77
- 2026-09-21: 77
- 2026-09-20: 76
- 2026-09-19: 76
- 2026-09-18: 73
- 2026-09-17: 72
- 2026-09-16: 72
- 2026-09-15: 71
- 2026-09-14: 71
- 2026-09-13: 70
- 2026-09-12: 70
- 2026-09-11: 69
- 2026-09-10: 69
- 2026-09-09: 69
- 2026-09-08: 68
- 2026-09-07: 68
- 2026-09-06: 67
- 2026-09-05: 67
- 2026-09-04: 66
- 2026-09-03: 66
- 2026-09-02: 65
- 2026-09-01: 65

## 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 42 tools: connection_info, disconnect, redeem_code, list_rooms, list_quick_actions, and 37 more. Their descriptions and schemas cost roughly 4,979 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 24 September 2026. Those dates come from our own scans of the registry and the channel itself, not from anything the publisher announced.

## Links

- Remote endpoint: https://api.pingroom.io/api/agent/mcp
- Website: https://pingroom.io/developers
- Changelog RSS feed: https://verifymcp.io/servers/io-pingroom-pingroom/api-agent-mcp.xml
- Changelog JSON feed: https://verifymcp.io/servers/io-pingroom-pingroom/api-agent-mcp.json
- HTML version of this page: https://verifymcp.io/servers/io-pingroom-pingroom/api-agent-mcp