mcpField
O
OnceAsk

OnceAsk

远程服务
onceask.com生产力02 周前更新

关于 OnceAsk

OnceAsk 是面向需要查询当前邮寄地址的 Agent 的联系人与地址簿 MCP 服务。它会先检查地址状态和授权,再处理实体寄送,而非默认联系人中保存的地址仍然有效。

主要功能

  1. 01解析联系人的寄送状态
  2. 02请求收件人授权或更新地址
  3. 03列出手写卡片设计
  4. 04使用寄送令牌发送卡片

适用场景

  1. 01寄送礼物前核实地址
  2. 02请收件人确认过期地址
  3. 03发送已获授权的手写卡片

MCP 相关

OnceAsk 通过 `https://onceask.com/_api/mcp` 提供联系人寄送状态查询和手写卡片工具。它会说明寄送是否已获授权、需要授权或更新地址、对象不明确或未找到。

配置

远程服务无需本地安装。选择你使用的客户端,复制配置或使用一键安装。

服务地址https://onceask.com/_api/mcp
一键复制安装命令
Claude CodeTerminal
Cursor.cursor/mcp.json
VS Code.vscode/mcp.json
Claude Desktopclaude_desktop_config.json
Windsurf~/.codeium/windsurf/mcp_config.json

命令在终端中运行;JSON 粘贴到对应客户端的 MCP 配置后重启。需要授权的服务会在首次连接时提示登录。

工具

4
参数类型必填说明
querystring否要解析的姓名或电子邮件(未知联系人 ID 时)
purposestring否实物配送的用途
contactIdstring否已知的 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"

网站

https://onceask.com

联系方式

[email protected]

评论

支持 Markdown

第一次接触 MCP?

从协议是什么,到在客户端里装上第一个服务,这几条回答覆盖了大多数入门问题。

一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。