{"name":"io.pingroom/pingroom","slug":"pingroom","title":"PingRoom","description":"Send mobile pings and route human questions, approvals, and handoffs from AI agents.","url":"https://mcp.market/server/pingroom","rating":null,"grade":"C","score":60,"certified":false,"status":"active","category":"other","tags":[],"presence":{"score":8,"stars":null,"forks":null,"downloads_week":null,"last_push_at":null,"license":null},"uptime":{"percent":100,"checks":7,"ok":7,"last_checked_at":"2026-09-21T06:10:53.247Z","last_ok_at":"2026-09-21T06:10:53.247Z","latency_ms":216},"claimed":false,"transport":"remote","callable_via_gateway":true,"default_price_micros":0,"repository":null,"website":"https://pingroom.io/developers","version":"0.1.0","remotes":[{"type":"streamable-http","url":"https://api.pingroom.io/api/agent/mcp"}],"packages":[],"tools":[{"name":"activate_agent_inbox","description":"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.","write_action":false,"price_micros":0,"input_schema":{"type":"object","properties":{},"additionalProperties":false}},{"name":"ask_question","description":"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.","write_action":false,"price_micros":0,"input_schema":{"type":"object","properties":{"invite_code":{"type":"string","description":"Room invite code."},"prompt":{"type":"string","maxLength":500,"description":"The question the person reads."},"context":{"type":"string","maxLength":40,"description":"Optional secondary line, e.g. a build number."},"options":{"type":"array","minItems":2,"maxItems":4,"description":"Answer options in display order. Omit for a default Approve/Deny.","items":{"type":"object","properties":{"value":{"type":"string","maxLength":40,"description":"Stable token returned as the answer."},"label":{"type":"string","maxLength":40,"description":"Button text shown to the person."},"style":{"type":"string","enum":["primary","danger","default"],"description":"primary = affirmative (brand color), danger = destructive (red), default = quiet."}},"required":["value","label"],"additionalProperties":false}},"text_input":{"type":"object","description":"Invite a typed answer (on its own, or alongside options). max_length is capped at 60.","properties":{"placeholder":{"type":"string","maxLength":60,"description":"Hint shown in the reply field."},"max_length":{"type":"integer","minimum":1,"maximum":60,"description":"Max characters (default 60)."}},"additionalProperties":false},"correlation_id":{"type":"string","maxLength":255,"description":"Your own id, echoed back unchanged on read."},"reply_to":{"type":"string","maxLength":255,"description":"Optional routing pointer, echoed back unchanged."},"data":{"type":"object","maxProperties":25,"description":"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.","properties":{"location":{"type":"object","description":"A shareable geographic location.","properties":{"latitude":{"type":"number","minimum":-90,"maximum":90,"description":"Latitude in decimal degrees."},"longitude":{"type":"number","minimum":-180,"maximum":180,"description":"Longitude in decimal degrees."},"label":{"type":"string","maxLength":100,"description":"Optional place name shown to the recipient."},"address":{"type":"string","maxLength":255,"description":"Optional formatted street address."}},"required":["latitude","longitude"],"additionalProperties":false}},"additionalProperties":true},"ttl":{"type":"integer","minimum":1,"description":"Seconds the question stays open before it expires."},"attachment_ids":{"type":"array","maxItems":4,"items":{"type":"string","format":"uuid"},"description":"Ids of up to 4 uploaded attachments (see upload_attachment) to include. Uploading requires a Pro account."},"idempotency_key":{"type":"string","minLength":1,"maxLength":255,"description":"Stable key so a retried call cannot create a second one."}},"required":["invite_code","prompt"],"additionalProperties":false}},{"name":"broadcast","description":"Send a custom ping to a room the account belongs to. Rate-limited. Not available in personal rooms (use trigger_quick_action there).","write_action":true,"price_micros":0,"input_schema":{"type":"object","properties":{"invite_code":{"type":"string","description":"Room invite code."},"message":{"type":"string","maxLength":160,"description":"Ping body text (max 120 characters in private rooms, 160 in public rooms)."},"title":{"type":"string","maxLength":40,"description":"Optional headline. Defaults to the room name."},"action_number":{"type":"integer","minimum":1,"maximum":16,"description":"Optional quick-action slot to attribute the ping to."},"action_icon":{"type":"string","maxLength":50,"description":"Optional emoji shown with the ping."},"data":{"type":"object","maxProperties":25,"description":"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.url + data.button_label are reserved for a tappable link ping.","properties":{"location":{"type":"object","description":"A shareable geographic location.","properties":{"latitude":{"type":"number","minimum":-90,"maximum":90,"description":"Latitude in decimal degrees."},"longitude":{"type":"number","minimum":-180,"maximum":180,"description":"Longitude in decimal degrees."},"label":{"type":"string","maxLength":100,"description":"Optional place name shown to the recipient."},"address":{"type":"string","maxLength":255,"description":"Optional formatted street address."}},"required":["latitude","longitude"],"additionalProperties":false},"url":{"type":"string","format":"uri","maxLength":2048,"description":"Reserved: an absolute http:// or https:// URL. Present turns the ping into a tappable link."},"button_label":{"type":"string","maxLength":26,"description":"Reserved: label for the link button rendered for data.url."},"label":{"type":"string","maxLength":26,"description":"Reserved: short caption shown with the link ping."}},"additionalProperties":true},"correlation_id":{"type":"string","maxLength":255,"description":"Your own id, echoed back unchanged on read."},"reply_to":{"type":"string","maxLength":255,"description":"Id of the ping this one answers (notification id or correlation id)."},"is_urgent":{"type":"boolean","description":"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 and asks nothing of the recipient."},"ack_mode":{"type":"string","enum":["any","all"],"description":"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."},"requires_ack":{"type":"boolean","description":"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 ack that also breaks through Focus."},"ack_timeout_seconds":{"type":"integer","minimum":60,"maximum":86400,"description":"Optional acknowledgement deadline in seconds."},"attachment_ids":{"type":"array","maxItems":4,"items":{"type":"string","format":"uuid"},"description":"Ids of up to 4 uploaded attachments (see upload_attachment) to include. Uploading requires a Pro account."}},"required":["invite_code","message"],"additionalProperties":false}},{"name":"cancel_question","description":"Withdraw a still-pending question you asked.","write_action":true,"price_micros":0,"input_schema":{"type":"object","properties":{"question_id":{"type":"string","format":"uuid","description":"Question id."}},"required":["question_id"],"additionalProperties":false}},{"name":"connection_info","description":"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.","write_action":false,"price_micros":0,"input_schema":{"type":"object","properties":{},"additionalProperties":false}},{"name":"create_handoff","description":"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.","write_action":true,"price_micros":0,"input_schema":{"type":"object","properties":{"kind":{"type":"string","enum":["ack","question"],"description":"ack asks the human to acknowledge; question asks them to choose an option."},"prompt":{"type":"string","maxLength":500,"description":"The work/request shown to the human."},"audience":{"type":"object","properties":{"type":{"type":"string","enum":["direct"]},"user_id":{"type":"string","enum":["me"],"description":"The authorizing human, expressed as the literal value \"me\"."}},"required":["type","user_id"],"additionalProperties":false},"expires_in":{"type":"integer","description":"Seconds before the handoff expires; the server clamps this to its safe range."},"urgency":{"type":"string","enum":["active","passive"],"description":"Notification interruption level. Defaults to active."},"options":{"type":"array","minItems":2,"maxItems":4,"description":"Required for question and forbidden for ack. Each item may be a label string or a structured option.","items":{"oneOf":[{"type":"string","maxLength":40},{"type":"object","properties":{"value":{"type":"string","maxLength":40},"label":{"type":"string","maxLength":40},"style":{"type":"string","enum":["primary","danger","default"]}},"required":["value","label"],"additionalProperties":false}]}},"data":{"type":"object","description":"Structured context returned on read surfaces after connector privacy filtering. Do not put secrets in data."},"correlation_id":{"type":"string","maxLength":255,"description":"Your own stable correlation id."},"reply_to":{"type":"string","maxLength":255,"description":"Optional routing pointer."},"idempotency_key":{"type":"string","minLength":1,"maxLength":255,"description":"Stable key for at-most-once creation across both Ack and Question kinds."}},"required":["kind","prompt","audience"],"additionalProperties":false}},{"name":"create_public_room","description":"Create a publicly discoverable room with a unique @handle. Counts toward the free-plan five-room cap.","write_action":true,"price_micros":0,"input_schema":{"type":"object","properties":{"name":{"type":"string","maxLength":24,"description":"Room display name."},"icon":{"type":"string","description":"A v3 room-icon catalog id, e.g. \"bell\". Call list_room_icons to discover the valid ids."},"color":{"type":"string","description":"Hex color, e.g. \"#e33122\"."},"handle":{"type":"string","pattern":"^[a-z0-9_]{3,20}$","description":"Globally unique @handle (vanity URL): lowercase letters, digits, underscores."},"description":{"type":"string","maxLength":120,"description":"Short room description shown in public discovery."},"category":{"type":"string","maxLength":100,"description":"Discovery category."},"show_owner":{"type":"boolean","description":"Whether the owner is shown publicly. Defaults to true."}},"required":["name","icon","color","handle"],"additionalProperties":false}},{"name":"create_room","description":"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.","write_action":true,"price_micros":0,"input_schema":{"type":"object","properties":{"name":{"type":"string","maxLength":24,"description":"Room display name."},"icon":{"type":"string","description":"A v3 room-icon catalog id, e.g. \"bell\". Call list_room_icons to discover the valid ids."},"color":{"type":"string","description":"Hex color, e.g. \"#e33122\"."}},"required":["name","icon","color"],"additionalProperties":false}},{"name":"create_webhook","description":"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.","write_action":true,"price_micros":0,"input_schema":{"type":"object","properties":{"invite_code":{"type":"string","description":"Room invite code."},"name":{"type":"string","maxLength":100,"description":"Webhook name (shown to the owner)."},"title":{"type":"string","maxLength":40,"description":"Optional push title used when the webhook fires."},"message":{"type":"string","maxLength":160,"description":"Optional default push body (max 120 characters in private rooms, 160 in public rooms)."},"icon":{"type":"string","description":"A v3 room-icon catalog id, e.g. \"bell\". Call list_room_icons to discover the valid ids."},"color":{"type":"string","description":"Hex color, e.g. \"#e33122\"."},"sound":{"type":"string","description":"Canonical sound id, e.g. \"ting\". Omit for the room default."},"action_number":{"type":"integer","minimum":1,"maximum":16,"description":"Quick-action slot to attribute fires to. Auto-assigned if omitted."},"enabled":{"type":"boolean","description":"Whether the webhook is active. Defaults to true."},"cooldown_seconds":{"type":"integer","minimum":0,"maximum":60,"description":"Minimum seconds between fires. Defaults to 5."}},"required":["invite_code","name"],"additionalProperties":false}},{"name":"delete_attachment","description":"Delete an attachment this agent uploaded that is not yet claimed by a ping.","write_action":true,"price_micros":0,"input_schema":{"type":"object","properties":{"attachment_id":{"type":"string","format":"uuid","description":"Attachment id returned by upload_attachment."}},"required":["attachment_id"],"additionalProperties":false}},{"name":"delete_webhook","description":"Delete an incoming webhook (by id) from a room the account owns.","write_action":true,"price_micros":0,"input_schema":{"type":"object","properties":{"invite_code":{"type":"string","description":"Room invite code."},"webhook_id":{"type":"string","description":"Webhook id (from list_webhooks or create_webhook)."}},"required":["invite_code","webhook_id"],"additionalProperties":false}},{"name":"disconnect","description":"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.","write_action":false,"price_micros":0,"input_schema":{"type":"object","properties":{},"additionalProperties":false}},{"name":"get_approval","description":"Fetch the current status of an approval request without blocking.","write_action":false,"price_micros":0,"input_schema":{"type":"object","properties":{"approval_id":{"type":"string","format":"uuid","description":"Approval request id."}},"required":["approval_id"],"additionalProperties":false}},{"name":"get_attachment","description":"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.","write_action":false,"price_micros":0,"input_schema":{"type":"object","properties":{"attachment_id":{"type":"string","format":"uuid","description":"Attachment id returned by upload_attachment."}},"required":["attachment_id"],"additionalProperties":false}},{"name":"get_handoff","description":"Fetch the authoritative current state of one Handoff without blocking.","write_action":false,"price_micros":0,"input_schema":{"type":"object","properties":{"handoff_id":{"type":"string","format":"uuid","description":"Handoff id."}},"required":["handoff_id"],"additionalProperties":false}},{"name":"get_live_status","description":"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.","write_action":false,"price_micros":0,"input_schema":{"type":"object","properties":{"invite_code":{"type":"string","description":"Room invite code."},"correlation_id":{"type":"string","maxLength":255,"description":"The stream key used when the stream was started."}},"required":["invite_code","correlation_id"],"additionalProperties":false}},{"name":"get_notification","description":"Fetch one visible ping by notification id, including its current action_state.","write_action":false,"price_micros":0,"input_schema":{"type":"object","properties":{"notification_id":{"type":"string","format":"uuid","description":"Room notification id."}},"required":["notification_id"],"additionalProperties":false}},{"name":"get_question","description":"Fetch the current state of a question without blocking.","write_action":false,"price_micros":0,"input_schema":{"type":"object","properties":{"question_id":{"type":"string","format":"uuid","description":"Question id."}},"required":["question_id"],"additionalProperties":false}},{"name":"get_room","description":"Fetch a single room by its invite code, including members and quick actions.","write_action":false,"price_micros":0,"input_schema":{"type":"object","properties":{"invite_code":{"type":"string","description":"Room invite code."}},"required":["invite_code"],"additionalProperties":false}},{"name":"join_room","description":"Join a room using its invite code. Include the password only if the room is protected.","write_action":false,"price_micros":0,"input_schema":{"type":"object","properties":{"invite_code":{"type":"string","description":"Room invite code."},"password":{"type":"string","description":"Only required for password-protected rooms."}},"required":["invite_code"],"additionalProperties":false}},{"name":"list_handoffs","description":"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.","write_action":false,"price_micros":0,"input_schema":{"type":"object","properties":{"state":{"type":"string","enum":["open","all"],"description":"Filter to open Handoffs or include all states."},"limit":{"type":"integer","minimum":1,"maximum":25,"default":10,"description":"Handoffs per page. Defaults to 10; maximum 25."},"page":{"type":"integer","minimum":1,"description":"Page number, newest first."}},"additionalProperties":false}},{"name":"list_notifications","description":"List a bounded page of recent pings across approved rooms, newest first. Use page to continue while has_more is true.","write_action":false,"price_micros":0,"input_schema":{"type":"object","properties":{"type":{"type":"string","enum":["received","sent"],"description":"Narrow to pings you received or pings you sent. Omit for both."},"date":{"type":"string","format":"date","description":"Only pings created on this calendar date, e.g. \"2026-08-25\"."},"limit":{"type":"integer","minimum":1,"maximum":25,"default":10,"description":"Pings per page. Defaults to 10; maximum 25."},"page":{"type":"integer","minimum":1,"description":"Page number, newest first."}},"additionalProperties":false}},{"name":"list_questions","description":"List a bounded page of questions you asked, newest first. Optionally filter by state; use page while has_more is true.","write_action":false,"price_micros":0,"input_schema":{"type":"object","properties":{"state":{"type":"string","enum":["pending","answered","expired","cancelled","all"],"description":"Filter by state. Omit for all."},"limit":{"type":"integer","minimum":1,"maximum":25,"default":10,"description":"Questions per page. Defaults to 10; maximum 25."},"page":{"type":"integer","minimum":1,"description":"Page number, newest first."}},"additionalProperties":false}},{"name":"list_quick_actions","description":"List the quick actions configured for a room.","write_action":false,"price_micros":0,"input_schema":{"type":"object","properties":{"invite_code":{"type":"string","description":"Room invite code."}},"required":["invite_code"],"additionalProperties":false}},{"name":"list_room_icons","description":"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.","write_action":false,"price_micros":0,"input_schema":{"type":"object","properties":{},"additionalProperties":false}},{"name":"list_rooms","description":"List the rooms the authenticated account belongs to.","write_action":false,"price_micros":0,"input_schema":{"type":"object","properties":{},"additionalProperties":false}},{"name":"list_webhooks","description":"List the incoming webhooks (with their trigger URLs) for a room the account owns.","write_action":false,"price_micros":0,"input_schema":{"type":"object","properties":{"invite_code":{"type":"string","description":"Room invite code."}},"required":["invite_code"],"additionalProperties":false}},{"name":"live_status","description":"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.","write_action":false,"price_micros":0,"input_schema":{"type":"object","properties":{"invite_code":{"type":"string","description":"Room invite code."},"correlation_id":{"type":"string","maxLength":255,"description":"The stream key. Reuse it on every ping of the same stream."},"live_status":{"type":"object","description":"The live card's state. Only state is required.","properties":{"state":{"type":"string","enum":["running","done","failed"],"description":"running keeps the card live; done/failed end it with one completion alert."},"template":{"type":"string","enum":["status","steps","progress","metrics","countdown","question","matchup"],"description":"Which layout the OS renders. Fixed at stream creation."},"category":{"type":"string","enum":["status","steps","alert"],"description":"Legacy rendering category; prefer template. \"alert\" has NO template equivalent and is the only way to start a stream time-sensitive (breaks through Focus). Fixed at stream creation."},"message":{"type":"string","maxLength":256,"description":"The card's live message line."},"progress":{"type":"number","minimum":0,"maximum":1,"description":"Progress bar / Dynamic Island gauge, 0..1."},"steps":{"type":"array","items":{"type":"string","maxLength":40},"minItems":2,"maxItems":8,"description":"Step labels. Required on the first ping of a steps stream; immutable afterwards."},"current_step":{"type":"integer","minimum":0,"maximum":8,"description":"Index into steps; the only mutable steps field."},"metrics":{"type":"array","maxItems":3,"items":{"type":"object","properties":{"label":{"type":"string","maxLength":24},"value":{"type":"string","maxLength":24}},"required":["label","value"],"additionalProperties":false},"description":"Up to 3 {label,value} counters for the metrics template."},"deadline_at":{"type":"integer","description":"Epoch seconds the countdown template counts down to."},"eta_at":{"type":"integer","description":"Epoch seconds; renders a live ETA on status/progress."},"prompt":{"type":"string","maxLength":256,"description":"The ask, for the question template."},"options":{"type":"array","maxItems":4,"items":{"type":"object","properties":{"value":{"type":"string","maxLength":64},"label":{"type":"string","maxLength":40}},"required":["value","label"],"additionalProperties":false},"description":"Up to 4 {value,label} choices for the question template."},"left":{"type":"object","properties":{"label":{"type":"string","maxLength":24},"value":{"type":"string","maxLength":24}},"required":["label","value"],"additionalProperties":false,"description":"Left side {label,value} for the matchup template."},"right":{"type":"object","properties":{"label":{"type":"string","maxLength":24},"value":{"type":"string","maxLength":24}},"required":["label","value"],"additionalProperties":false,"description":"Right side {label,value} for the matchup template."},"center":{"type":"string","maxLength":40,"description":"Center score/clock for the matchup template."},"accent_override":{"type":"string","description":"Hex #rrggbb; a semantic accent for one frame (e.g. deadline red)."}},"required":["state"],"additionalProperties":false},"title":{"type":"string","maxLength":40,"description":"Card title. Defaults to the selected quick action's label."},"action":{"type":"integer","minimum":1,"maximum":16,"description":"Quick-action slot to attribute the stream to (supplies the icon and sound)."},"data":{"type":"object","description":"Arbitrary structured context (max 25 keys / 8KB), returned on read surfaces after connector privacy filtering. Do not put secrets in data."},"requires_ack":{"type":"boolean","description":"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."},"ack_timeout_seconds":{"type":"integer","minimum":1,"maximum":86400,"description":"Optional acknowledgement deadline in seconds."}},"required":["invite_code","correlation_id","live_status"],"additionalProperties":false}},{"name":"redeem_code","description":"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.","write_action":false,"price_micros":0,"input_schema":{"type":"object","properties":{"code":{"type":"string","pattern":"^[ \\t\\r\\n]*[A-Za-z0-9]{12}[ \\t\\r\\n]*$","description":"The 12-letter/digit gift or promo code. Case-insensitive; surrounding whitespace is trimmed."}},"required":["code"],"additionalProperties":false}},{"name":"request_approval","description":"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.","write_action":false,"price_micros":0,"input_schema":{"type":"object","properties":{"invite_code":{"type":"string","description":"Room invite code."},"question":{"type":"string","maxLength":500,"description":"What you want the human to decide on."},"title":{"type":"string","maxLength":40,"description":"Optional short title for the request."},"options":{"type":"array","items":{"type":"string","maxLength":40},"minItems":2,"maxItems":4,"description":"Answers to choose between. Defaults to [\"approve\",\"deny\"]."},"correlation_id":{"type":"string","maxLength":255,"description":"Your own id, echoed back unchanged on read."},"data":{"type":"object","description":"Arbitrary structured context, returned on reads after connector privacy filtering. Do not put secrets in data."},"ttl":{"type":"integer","minimum":1,"description":"Seconds the request stays open before it expires."},"idempotency_key":{"type":"string","minLength":1,"maxLength":255,"description":"Stable key so a retried call cannot create a second one."}},"required":["invite_code","question"],"additionalProperties":false}},{"name":"rotate_handle","description":"Rotate this agent's public handle — kill-switch for a leaked handle.","write_action":false,"price_micros":0,"input_schema":{"type":"object","properties":{},"additionalProperties":false}},{"name":"set_avatar","description":"Set this agent's avatar. Must be one of the PingRoom bot avatars.","write_action":false,"price_micros":0,"input_schema":{"type":"object","properties":{"avatar_id":{"type":"string","description":"Bot avatar id, e.g. \"bots-3\"."}},"required":["avatar_id"],"additionalProperties":false}},{"name":"trigger_quick_action","description":"Press a room quick action, notifying its members. Rate-limited.","write_action":false,"price_micros":0,"input_schema":{"type":"object","properties":{"invite_code":{"type":"string","description":"Room invite code."},"action_number":{"type":"integer","minimum":1,"maximum":16,"description":"Quick-action slot number (1–16). Slots 5–16 require the room owner to have Pro."},"trigger_source":{"type":"string","enum":["manual","location"],"description":"Defaults to \"manual\". Only these two are client-settable — \"webhook\" and \"system\" are stamped server-side and are rejected here."},"is_urgent":{"type":"boolean","description":"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 is unchanged."},"ack_mode":{"type":"string","enum":["any","all"],"description":"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."},"requires_ack":{"type":"boolean","description":"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 stored ack policy."}},"required":["invite_code","action_number"],"additionalProperties":false}},{"name":"update_quick_action","description":"Configure a numbered quick-action slot for a room the account owns.","write_action":true,"price_micros":0,"input_schema":{"type":"object","properties":{"invite_code":{"type":"string","description":"Room invite code."},"action_number":{"type":"integer","minimum":1,"maximum":16,"description":"Quick-action slot number (1–16). Slots 5–16 require the room owner to have Pro."},"label":{"type":"string","maxLength":255,"description":"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."},"icon":{"type":"string","description":"Emoji or icon id."},"sound":{"type":"string","description":"Canonical sound id, e.g. \"ting\". Omit for the room default."},"requires_ack":{"type":"boolean","description":"Whether pings from this action remain open until one eligible recipient acknowledges them."}},"required":["invite_code","action_number","label","icon"],"additionalProperties":false}},{"name":"update_quick_actions","description":"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.","write_action":true,"price_micros":0,"input_schema":{"type":"object","properties":{"invite_code":{"type":"string","description":"Room invite code."},"actions":{"type":"array","minItems":1,"maxItems":16,"description":"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 configuration — nothing in this tool deletes an action.","items":{"type":"object","properties":{"action_number":{"type":"integer","minimum":1,"maximum":16,"description":"Quick-action slot number (1–16). Slots 5–16 require the room owner to have Pro."},"label":{"type":"string","maxLength":255,"description":"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."},"icon":{"type":"string","description":"Emoji or icon id."},"sound":{"type":"string","description":"Canonical sound id, e.g. \"ting\". Omit for the room default."},"requires_ack":{"type":"boolean","description":"Whether pings from this action remain open until one eligible recipient acknowledges them."}},"additionalProperties":false,"required":["action_number","label","icon"]}}},"required":["invite_code","actions"],"additionalProperties":false}},{"name":"update_webhook","description":"Update an incoming webhook (by id) on a room the account owns — e.g. change its icon, title, message, or sound.","write_action":true,"price_micros":0,"input_schema":{"type":"object","properties":{"invite_code":{"type":"string","description":"Room invite code."},"webhook_id":{"type":"string","description":"Webhook id (from list_webhooks or create_webhook)."},"name":{"type":"string","maxLength":100,"description":"Webhook name (shown to the owner)."},"title":{"type":"string","maxLength":40,"description":"Push title used when the webhook fires."},"message":{"type":"string","maxLength":160,"description":"Default push body (max 120 characters in private rooms, 160 in public rooms)."},"icon":{"type":"string","description":"A v3 room-icon catalog id, e.g. \"bell\". Call list_room_icons to discover the valid ids."},"color":{"type":"string","description":"Hex color, e.g. \"#e33122\"."},"sound":{"type":"string","description":"Canonical sound id, e.g. \"ting\"."},"action_number":{"type":"integer","minimum":1,"maximum":16,"description":"Quick-action slot to attribute fires to."},"enabled":{"type":"boolean","description":"Whether the webhook is active."},"cooldown_seconds":{"type":"integer","minimum":0,"maximum":60,"description":"Minimum seconds between fires."},"regenerate_secret":{"type":"boolean","description":"Rotate the secret trigger URL."}},"required":["invite_code","webhook_id"],"additionalProperties":false}},{"name":"upload_attachment","description":"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.","write_action":true,"price_micros":0,"input_schema":{"type":"object","properties":{"filename":{"type":"string","minLength":1,"maxLength":255,"description":"File name including extension, e.g. report.md."},"content_base64":{"type":"string","minLength":1,"maxLength":124000,"description":"Base64-encoded file bytes (standard alphabet, padding optional)."},"mime_type":{"type":"string","maxLength":100,"description":"Optional MIME type, e.g. text/markdown. Defaults from the filename extension."}},"required":["filename","content_base64"],"additionalProperties":false}},{"name":"wait_for_ack","description":"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.","write_action":false,"price_micros":0,"input_schema":{"type":"object","properties":{"notification_id":{"type":"string","format":"uuid","description":"Room notification id."},"timeout":{"type":"integer","minimum":0,"maximum":30,"description":"Seconds to hold the request open. Use 0 for an immediate authoritative state read."}},"required":["notification_id"],"additionalProperties":false}},{"name":"wait_for_answer","description":"Long-poll a question until it is answered or expires. Returns the state and, once answered, the chosen option value + label and the responder.","write_action":false,"price_micros":0,"input_schema":{"type":"object","properties":{"question_id":{"type":"string","format":"uuid","description":"Question id."},"timeout":{"type":"integer","minimum":1,"maximum":30,"description":"Seconds to hold the request open (server-capped)."}},"required":["question_id"],"additionalProperties":false}},{"name":"wait_for_approval","description":"Long-poll an approval request until the human decides or it expires. Returns the status and, once decided, the chosen option.","write_action":false,"price_micros":0,"input_schema":{"type":"object","properties":{"approval_id":{"type":"string","format":"uuid","description":"Approval request id."},"timeout":{"type":"integer","minimum":1,"maximum":30,"description":"Seconds to hold the request open (server-capped)."}},"required":["approval_id"],"additionalProperties":false}},{"name":"wait_for_handoff","description":"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.","write_action":false,"price_micros":0,"input_schema":{"type":"object","properties":{"handoff_id":{"type":"string","format":"uuid","description":"Handoff id."},"timeout":{"type":"integer","minimum":0,"maximum":25,"description":"Seconds to hold the request open; use 0 for an immediate state read."}},"required":["handoff_id"],"additionalProperties":false}},{"name":"wait_for_notification","description":"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.","write_action":false,"price_micros":0,"input_schema":{"type":"object","properties":{"after":{"type":"string","format":"uuid","description":"Cursor from the previous call; omit to get the current head."},"timeout":{"type":"integer","minimum":1,"maximum":30,"description":"Seconds to hold the request open (server-capped)."}},"additionalProperties":false}}],"scan":{"score":60,"grade":"C","scanned_at":"2026-09-20T20:12:03.866Z","report":{"scannerVersion":"0.1.9","scannedAt":"2026-09-20T20:12:03.683Z","components":{"code":{"score":-1,"max":25,"notes":["remote-only server, no package to scan"]},"reliability":{"score":20,"max":20,"notes":["remote reachable in 1913ms"]},"poisoning":{"score":15,"max":15,"notes":["42 tool descriptions checked"]},"auth":{"score":3,"max":15,"notes":["open endpoint exposes 12 write-action tools with no auth"]},"maintenance":{"score":3,"max":15,"notes":["no repository listed"]},"identity":{"score":4,"max":10,"notes":["verified namespace with website, no repo"]}},"findings":[{"id":"auth.open-write","severity":"high","component":"auth","title":"Write-action tools reachable without authentication"},{"id":"maint.no-repo","severity":"low","component":"maintenance","title":"No source repository listed"}],"inputs":{"probes":[{"url":"https://api.pingroom.io/api/agent/mcp","reachable":true,"authRequired":false,"latencyMs":1913,"serverInfo":{"name":"PingRoom","version":"0.1.0"}}],"packages":[],"repo":{"found":false},"icon":{"url":"https://pingroom.io/Pingroom-icon.png","source":"registry","width":400,"height":400},"presence":{"stars":null,"forks":null,"downloadsWeek":null,"license":null,"lastPushAt":null,"score":8}}}},"grade_history":[],"reviews":[]}