PingRoom

io.pingroom由 pingroom.io 發布官方發布者v0.1.0更新於 Oct 24, 2026

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

已驗證Streamable HTTP可網頁執行溝通與協作

概覽

AI 產生的概覽

讓助理傳送手機提醒,並把人員問題、審批與交接轉給真人。

可以做什麼
PingRoom 是一個遠端 MCP 伺服器,透過手機提醒把 AI 助理與人連結起來。根據註冊表描述,它傳送手機提醒,並轉達來自 AI 代理的人員問題、審批與交接。清單與描述中未列出具體工具,因此這裡無法說明確切的操作用法。
適用情境
當代理需要聯繫使用手機的人時使用,例如提問、請求審批,或把任務交接給真人。它面向代理必須暫停等待人工輸入、而非獨自完成全部工作的流程。
執行需求
遠端 MCP 端點,位址為 streamable HTTP;未宣告本機套件、執行環境、環境變數或標頭。清單宣告無需身分驗證,因此沒有記錄任何憑證。需要能連線至該端點的網路。
安裝前請注意
註冊表描述提到審批與交接,因此此伺服器可能把代理的請求轉達給人員,並把回覆帶回;經它傳送的內容應視為已離開你的環境。清單未宣告任何身分驗證、環境變數或標頭,端點如何保護以及誰能存取都未說明。未公布工具清單,依賴它之前請先確認它能傳送或變更什麼。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 PingRoom,將其新增到工作區。
  2. 為需要使用其工具的對話啟用該服務。

Web executable,透過 Streamable HTTP。 遠端服務在工作區中設定後即可從網頁執行環境執行。

交給代理程式安裝

把這段提示詞貼上到 Claude Code、Codex、Cursor 等代理程式,或 SourceWeft 對話中。代理程式會讀取該伺服器的安裝指南,先向你展示發布者、端點和登入方式,經你同意後再把它新增到你的客戶端。金鑰不會寫進任何命令。

閱讀 https://sourceweft.com/mcp/io.pingroom%2Fpingroom/install.md,並按其中說明把這個 MCP 伺服器接入我的客戶端。修改任何設定之前,先告訴我它的發布者、端點和登入方式,等我確認。不要把 API 金鑰寫進命令或我會提交的檔案;問我金鑰應從哪裡取得。

檢視代理程式所依據的安裝指南

其他 MCP 客戶端

把它新增到你客戶端的 mcpServers 設定中。

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

工具

41

connection_info

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.

無需輸入參數。

disconnect

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.

無需輸入參數。

list_rooms

List Rooms

List the rooms the authenticated account belongs to.

無需輸入參數。

list_quick_actions

List Quick Actions

List the quick actions configured for a room.

輸入參數invite_code必填

trigger_quick_action

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. In someone else's personal room is_urgent and requires_ack are ignored; only the owner's own setting on the action applies.

輸入參數dataack_modeis_urgentinvite_code必填requires_ackaction_number必填attachment_idstrigger_sourcequick_action_id

broadcast

Broadcast Ping

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.

輸入參數datatitlemessage必填ack_modereply_tois_urgentaction_iconinvite_code必填requires_ackaction_numberattachment_idscorrelation_id另有 1 個

live_status

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 of an open stream are never charged; a first ping that is already "done"/"failed" counts as a new stream.

輸入參數datatitleactioninvite_code必填live_status必填requires_ackcorrelation_id必填ack_timeout_seconds

get_live_status

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, duration_seconds, 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.

輸入參數invite_code必填correlation_id必填

list_room_icons

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.

無需輸入參數。

list_notifications

List Notifications

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

輸入參數datepagetypelimit

get_notification

Get Notification

Fetch one visible ping by notification id, including its current action_state and, once anything on its data.checklist is checked, checklist_state.

輸入參數notification_id必填

wait_for_notification

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.

輸入參數aftertimeout

wait_for_ack

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.

輸入參數timeoutnotification_id必填

request_approval

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

輸入參數ttldatatitleoptionsquestion必填invite_code必填correlation_ididempotency_key

wait_for_approval

Wait for Approval

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

輸入參數timeoutapproval_id必填

get_approval

Get Approval

Fetch the current status of an approval request without blocking.

輸入參數approval_id必填

ask_question

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.

輸入參數ttldataprompt必填contextoptionsreply_totext_inputinvite_code必填attachment_idscorrelation_ididempotency_key

wait_for_answer

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.

輸入參數timeoutquestion_id必填

get_question

Get Question

Fetch the current state of a question without blocking.

輸入參數question_id必填

list_questions

List Questions

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

輸入參數pagelimitstate

cancel_question

Cancel Question

Withdraw a still-pending question you asked.

輸入參數question_id必填

activate_agent_inbox

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.

無需輸入參數。

create_handoff

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.

輸入參數datakind必填prompt必填optionsurgencyaudience必填reply_toexpires_incorrelation_ididempotency_key

wait_for_handoff

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.

輸入參數timeouthandoff_id必填

get_handoff

Get Handoff

Fetch the authoritative current state of one Handoff without blocking.

輸入參數handoff_id必填

list_handoffs

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.

輸入參數pagelimitstate

upload_attachment

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.

輸入參數filename必填mime_typecontent_base64必填

get_attachment

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.

輸入參數attachment_id必填

delete_attachment

Delete Attachment

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

輸入參數attachment_id必填

get_room

Get Room

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

輸入參數invite_code必填

create_room

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.

輸入參數icon必填name必填color必填

create_public_room

Create Public Room

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

輸入參數icon必填name必填color必填handle必填categoryshow_ownerdescriptionlocation_namelocation_latitudelocation_longitude

join_room

Join Room

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

輸入參數passwordinvite_code必填

list_webhooks

List Webhooks

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

輸入參數invite_code必填

create_webhook

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.

輸入參數iconname必填colorsoundtitleenabledmessageinvite_code必填action_numbercooldown_seconds

update_webhook

Update Webhook

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

輸入參數iconnamecolorsoundtitleenabledmessagewebhook_id必填invite_code必填action_numbercooldown_secondsregenerate_secret

delete_webhook

Delete Webhook

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

輸入參數webhook_id必填invite_code必填

update_quick_action

Update Quick Action

Configure a numbered quick-action slot for a room the account owns. Sends a background room refresh to room members' devices.

輸入參數icon必填label必填soundinput_typeinvite_code必填requires_ackaction_number必填

update_quick_actions

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

輸入參數actions必填invite_code必填

set_avatar

Set Agent Avatar

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

輸入參數avatar_id必填

rotate_handle

Rotate Agent Handle

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

無需輸入參數。

版本歷史

1
  1. v0.1.0最新Sep 16, 2026

評分

已滿足適用檢查項的 83%

該評分衡量此收錄條目的完整程度,依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價,也不表示伺服器安全或目前可用:可連通性是帶日期的檢查結果,評分也不包含安裝量或使用者評價。

  • 近 30 天內可連通必需25 分
  • 已宣告認證方式必需10 分
  • 已列出工具必需15 分
  • 描述必需15 分
  • 圖示10 分
  • 文件15 分

    請宣告包含 README 的 GitHub 儲存庫,或在 OAuth 受保護資源後設資料中提供 resource_documentation。

  • 授權條款不適用

    託管服務按其提供方的條款使用,因此這裡不要求授權條款。此檢查項不計入百分比。