关于 A2A Passport — one GTIN, one call, everything GSC knows, signed
A2A Passport(README 中称 A2A Record)是产品 GTIN 或零售横幅的签名记录服务,实时汇集 GSC 枢纽中的现有记录。它面向需要查看来源、市场准入和签名有效性的贸易参与者;不会推断缺失信息。
主要功能
- 01按 GTIN 或横幅获取记录
- 02实时读取 GSC 枢纽数据
- 03列出记录并按条件筛选
- 04验证签名、版本链与时间戳
适用场景
- 01查看产品在各枢纽中的记录和准入信息
- 02核验记录签名及版本链
- 03按市场或类型筛选登记记录
MCP 相关
通过 streamable-HTTP 提供 get_record、list_records 和 verify_record 三个工具,供 MCP 客户端读取和验证签名记录。
配置
远程服务无需本地安装。选择你使用的客户端,复制配置或使用一键安装。
https://mcp.a2a-passport.ai/mcpclaude mcp add --transport http greencore-solutions-a2a-passport https://mcp.a2a-passport.ai/mcp{"mcpServers":{"greencore-solutions-a2a-passport":{"type":"http","url":"https://mcp.a2a-passport.ai/mcp"}}}在 Cursor 中打开{"servers":{"greencore-solutions-a2a-passport":{"type":"http","url":"https://mcp.a2a-passport.ai/mcp"}}}在 VS Code 中打开{"mcpServers":{"greencore-solutions-a2a-passport":{"type":"http","url":"https://mcp.a2a-passport.ai/mcp"}}}{"mcpServers":{"greencore-solutions-a2a-passport":{"serverUrl":"https://mcp.a2a-passport.ai/mcp"}}}命令在终端中运行;JSON 粘贴到对应客户端的 MCP 配置后重启。需要授权的服务会在首次连接时提示登录。
工具
3| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| kind | any | 否 | |
| subject | string | 是 |
详细介绍
A2A Record——一个 GTIN,一次调用,获取 GSC 所知的一切,并经过签名
各枢纽就是记录;A2A-Record.ai 负责签发记录。
各枢纽就是记录;A2A-Record.ai 负责签发记录。记录是针对产品或零售品牌的签名文档:记录存放在哪个枢纽、在哪些地方已获准、由谁上架,以及付款入口在哪里。记录由 GSC 枢纽实时签发,每周盖章。A2A Record 由 GreenCore Solutions Corp. 运营:每个产品(全球贸易项目代码,GTIN)或零售品牌对应一份签名文档,由 GSC 枢纽实时汇编——包括 A2A Grocery、A2A Cosmetics、A2A Peptides、A2A Retailmedia 以及合规记录——并使用 EdDSA 签名。提供三个工具:get_record、list_records、verify_record。每个字段都是某个枢纽的原话,并附有入口和读取时间;否则就会附注说明该字段不存在:记录绝不推断。没有任何枢纽持有记录的产品不会获得记录。读取开放;经过验证并会签的副本通过 x402 结算。人工智能会出错。A2A Record 是 Agent 信息源,不构成建议。永不投放广告。不出售排名。仅供贸易使用。
A2A Record 由 GreenCore Solutions Corp.(github.com/greencore-solutions)构建并运营。这是公开接入套件,采用 MIT 许可。
接入入口
streamable-HTTP,无状态,服务名称为 a2a-record,入口版本 1.0.2,提供 3 个工具(从通信协议读取)
- 端点:
https://mcp.a2a-record.ai/mcp——任何支持 streamable-HTTP 的客户端:{ "url": "https://mcp.a2a-record.ai/mcp", "transport": "streamable-http" } - Agent Card(已签名):
https://a2a-record.ai/.well-known/agent-card.json - 密钥:
https://a2a-record.ai/.well-known/jwks.json(EdDSA,密钥 ID 为a2apass-2026-10) - 无需注册,也无需令牌:每次读取均开放。
工具
get_record——获取产品(全球贸易项目代码,GTIN)或零售品牌(市场/品牌,例如 FR/Carrefour)的签名记录:哪个枢纽持有其记录、在哪些地方已获准、其合规记录、由谁上架,以及付款入口在哪里。每次调用都会从 GSC 枢纽实时读取;首次调用签发版本 1。subject = GTIN(8 至 14 位数字)或市场/品牌;kind = gtin 或 banner(可选)。list_records——查看登记簿中的记录:ID、类型、市场、版本和签发时间,按最新优先排序。不含正文。可按 kind(gtin 或 banner)、market 或签发时间筛选;支持分页。verify_record——检查记录:签名是否有效、版本链是否完整、印章有多旧,以及是否有任何部分未读取。从发布于 /.well-known/jwks.json 的密钥进行验证。
文档
两种类型共用一种封装格式(按 GTIN 标识的产品,或格式为 market/banner 的零售品牌):record_id、kind、subject、issued_at、version、previous_version_hash、issuer、signature、delta 和 body。
正文中的每个字段都是某个枢纽的原话,并附有入口、工具和读取时间;否则就会附注说明该字段不存在。记录绝不推断。
- 当前版本:
https://a2a-record.ai/record/{id}.json - 单个版本:
https://a2a-record.ai/record/{id}/v{n}.json - 记录 #1:
https://a2a-record.ai/record/gtin-03284230006408.json - 登记簿(实时计数):
https://a2a-record.ai/records/register.json
没有任何枢纽持有记录的产品不会获得记录。
自行验证记录
签名是对不含 signature 字段的记录所做的独立 JSON Web Signature(EdDSA),采用排序后的密钥、紧凑 JSON 和 UTF-8。examples/verify_record.py 使用已发布的密钥即可完成验证,无需其他内容。
会签副本
读取记录免费。经过验证并会签的副本通过 https://a2a-record.ai/api 结算(x402,包含两个 accept 条目)。未登记的记录会返回 HTTP 403,且不收费。
示例
examples/generic_mcp_client.py— 一个标准客户端:列出工具、读取记录 #1,并在门上验证它。examples/verify_record.py— 通过普通 HTTP 获取记录和密钥,并离线验证签名。
人工智能会犯错。A2A Record 是一个 Agent 信息源,不构成推荐。绝无广告。不出售排名。仅供交易。
评论
一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。