关于 OnceAsk
OnceAsk 是面向需要查询当前邮寄地址的 Agent 的联系人与地址簿 MCP 服务。它会先检查地址状态和授权,再处理实体寄送,而非默认联系人中保存的地址仍然有效。
主要功能
- 01解析联系人的寄送状态
- 02请求收件人授权或更新地址
- 03列出手写卡片设计
- 04使用寄送令牌发送卡片
适用场景
- 01寄送礼物前核实地址
- 02请收件人确认过期地址
- 03发送已获授权的手写卡片
MCP 相关
OnceAsk 通过 `https://onceask.com/_api/mcp` 提供联系人寄送状态查询和手写卡片工具。它会说明寄送是否已获授权、需要授权或更新地址、对象不明确或未找到。
配置
远程服务无需本地安装。选择你使用的客户端,复制配置或使用一键安装。
https://onceask.com/_api/mcpclaude mcp add --transport http rsb6061-onceask https://onceask.com/_api/mcp{"mcpServers":{"rsb6061-onceask":{"type":"http","url":"https://onceask.com/_api/mcp"}}}在 Cursor 中打开{"servers":{"rsb6061-onceask":{"type":"http","url":"https://onceask.com/_api/mcp"}}}在 VS Code 中打开{"mcpServers":{"rsb6061-onceask":{"type":"http","url":"https://onceask.com/_api/mcp"}}}{"mcpServers":{"rsb6061-onceask":{"serverUrl":"https://onceask.com/_api/mcp"}}}命令在终端中运行;JSON 粘贴到对应客户端的 MCP 配置后重启。需要授权的服务会在首次连接时提示登录。
工具
4| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| query | string | 否 | 要解析的姓名或电子邮件(未知联系人 ID 时) |
| purpose | string | 否 | 实物配送的用途 |
| contactId | string | 否 | 已知的 OnceAsk 联系人 ID |
详细介绍
OnceAsk MCP — 联系人 + 当前邮寄地址
OnceAsk 的官方 MCP 发现仓库,是一款联系人和地址簿 MCP,供需要获取某人的当前邮寄地址(而不只是联系人记录中保存的上一个地址)的 AI Agent 使用。
地址会变。OnceAsk 会保持地址最新。
OnceAsk 可帮助 AI 助手将已知联系人匹配到当前且获授权的投递目的地;如果地址缺失或已过时,也可以请求更新。
MCP 端点
https://onceask.com/_api/mcp
传输方式:Streamable HTTP
注册表标识:io.github.rsb6061/onceask
OnceAsk 有何不同
传统的联系人集成可以告诉 Agent 某人是谁,并提供该联系人的已存储字段。OnceAsk 关注下一个问题:此人的邮寄地址对于这次实物投递是否仍然有效且可用?
OnceAsk 可以返回明确的投递状态,而不是默认将已保存的地址视为当前地址:
authorized— 收件人已准备好进行获授权的投递。permission_required— 请求收件人授权。address_update_required— 请收件人确认或更新当前地址。ambiguous— 询问用户指的是哪位匹配的联系人。not_found— 先收集或创建收件人信息。
核心 MCP 工具
resolve_delivery
将已知人员或联系人解析为当前投递状态。这是需要寄送实物的 AI Agent 首选的基础工具。
request_delivery_permission
当地址缺失、已过时或尚未获得授权时,触发收件人确认流程。
list_handwritten_cards
列出支持的 Handwrytten 卡片设计和手写风格,不会暴露收件人数据。
send_handwritten_card
使用不透明的投递令牌完成已获授权的卡片投递。首选流程不会将收件人的原始街道地址作为普通模型输出返回。
Agent 工作流示例
- “给 Theresa 阿姨寄一张生日贺卡。”
- “给这位客户邮寄一份感谢礼物。”
- “寄出邀请函前,获取 John 当前的邮寄地址。”
- “向 Sarah 询问她的新地址。”
- “寄文件给 Mike,不要依赖旧 CRM 记录中的地址。”
Agent 可以根据现有上下文识别联系人,然后使用 OnceAsk 解析当前投递状态。
实用链接
在线目录列表
这些列表指向同一个生产端点和注册表标识:io.github.rsb6061/onceask。
MCP 注册表
注册表元数据定义于 server.json。
验证官方注册表列表:
curl "https://registry.modelcontextprotocol.io/v0.1/servers?search=io.github.rsb6061/onceask"
网站
联系方式
评论
一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。