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 集成