OnceAsk

io.github.rsb6061由 GitHub 帳號 rsb6061 發布v1.0.0更新於 Oct 24, 2026

MCP server for OnceAsk, the AI-native current-address layer for people and agents.

發布方自己的服務:ONCE

已驗證Streamable HTTP可網頁執行效率與工作流溝通與協作

概覽

AI 產生的概覽

OnceAsk 是遠端 MCP 伺服器,讓助理確認某人的郵寄地址是否最新且已獲授權,並寄送賀卡等實體郵件

可以做什麼
把聯絡人解析為投遞狀態:已授權、需要許可、需要更新地址、有歧義或找不到;在 OnceAsk 帳號已連結時,還會在其聯絡人與來自 Google 的聯絡人中查找,並在使用者明確確認後寄電子郵件向收件人索取目前地址或授權。列出可用的手寫賀卡設計與手寫風格,且不揭露收件人資料。使用短期一次性投遞權杖完成手寫賀卡寄送,地址直接送給履約服務商,而不回傳給助理。
適用情境
適合助理需要向已知聯絡人寄送實體物品的情境,例如生日賀卡、答謝禮物、邀請函或文件,而現有聯絡人記錄中的地址可能已過期或未經確認。也適合在寄送前請收件人確認或更新地址。
執行需求
需要連線到 onceask.com 上的遠端 Streamable HTTP 端點;未宣告任何套件、環境變數或請求標頭。簽發投遞權杖前需要收件人授權與目前地址。只有在 OnceAsk 帳號連結了 Google 聯絡人或其他來源時,才會從這些來源查找人員。
安裝前請注意
寄送手寫賀卡是真實世界操作,會實際寄出郵件,並可能透過履約服務商產生費用。伺服器會寄電子郵件向收件人索取地址或授權,因此應僅在使用者明確確認後執行。收件人的街道地址會送給履約服務商,不會回傳給助理。清單未宣告身分驗證,使用前請確認端點的安全方式。

安裝

在 SourceWeft 中

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

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

交給代理程式安裝

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

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

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

其他 MCP 客戶端

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

{
  "mcpServers": {
    "onceask": {
      "type": "http",
      "url": "https://onceask.com/_api/mcp"
    }
  }
}

README

OnceAsk MCP — Contacts + Current Mailing Addresses

Official MCP discovery repo for OnceAsk, a contacts and address-book MCP for AI agents that need a person's current mailing address, not just the last address stored in a contact record.

Addresses change. OnceAsk keeps them current.

OnceAsk helps an AI assistant resolve a known person to a current, permissioned delivery destination or request an update when the address is missing or stale.

MCP endpoint

https://onceask.com/_api/mcp

Transport: Streamable HTTP

Registry identity: io.github.rsb6061/onceask

What makes OnceAsk different

A conventional contacts integration can tell an agent who a person is and expose whatever fields are stored for that contact. OnceAsk focuses on the next problem: is this person's mailing address current and usable for this physical-delivery action?

OnceAsk can return an explicit delivery state instead of treating a saved address as automatically current:

  • authorized — the recipient is ready for an authorized delivery action.
  • permission_required — request recipient permission.
  • address_update_required — ask the recipient to confirm or update the current address.
  • ambiguous — ask the user which matching person they mean.
  • not_found — collect or create the recipient first.

Core MCP tools

resolve_delivery

Resolve a known person or contact to a current delivery state. This is the preferred primitive for AI agents that need to send something physical.

request_delivery_permission

Trigger the recipient-confirmation flow when an address is missing, stale, or not yet authorized.

list_handwritten_cards

List supported Handwrytten card designs and handwriting styles without exposing recipient data.

send_handwritten_card

Fulfill an authorized card delivery using an opaque delivery token. The preferred flow does not return the recipient's raw street address as ordinary model output.

Example agent workflows

  • "Send Aunt Theresa a birthday card."
  • "Mail this client a thank-you gift."
  • "Get John's current mailing address before we send the invitation."
  • "Ask Sarah for her new address."
  • "Send the document to Mike without relying on the address in our old CRM record."

The agent can identify the person from its existing context, then use OnceAsk to resolve the current delivery state.

Useful links

Live directory listings

These listings point to the same production endpoint and registry identity: io.github.rsb6061/onceask.

MCP Registry

The registry metadata is defined in server.json.

To verify the official registry listing:

bash
curl "https://registry.modelcontextprotocol.io/v0.1/servers?search=io.github.rsb6061/onceask"

Website

https://onceask.com

Contact

[email protected]

來源:README.md,提交 8ea8583

工具

4

resolve_delivery

Resolve private delivery

Preferred privacy-preserving way to send something to a person. Searches OnceAsk first and, when connected, can discover a missing person from Google Contacts or Gmail interactions. Resolves to a short-lived one-time delivery token when recipient permission and a current address exist. Does not return the street address.

輸入參數querypurposecontactId

request_delivery_permission

Request private delivery permission

After the user explicitly confirms they want the recipient contacted, ask OnceAsk to request a current delivery address/permission. Accepts either a recipientId from resolve_delivery or a person's name/email. OnceAsk searches its contacts and connected Google/Gmail-derived people, then emails the secure request when possible without revealing the recipient email or street address to the agent.

輸入參數querycontactIdcustomMessage

list_handwritten_cards

Browse handwritten cards

List available Handwrytten card designs and handwriting styles for privacy-preserving fulfillment. Does not expose recipient address data.

無需輸入參數。

send_handwritten_card

Send handwritten card

Fulfill a handwritten card using a delivery token returned by resolve_delivery. OnceAsk sends the recipient address directly to the fulfillment provider; the agent does not receive it.

輸入參數cardId必填wishesmessage必填fontLabeldeliveryToken必填

版本歷史

1
  1. v1.0.0最新Sep 16, 2026

評分

已滿足適用檢查項的 90%

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

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

    請在儲存庫或註冊中心條目中宣告授權條款。

其他 Once 整合