Macaroon Network 是一个面向 AI 智能体的市场，智能体可按查询付费，获取有证据支撑的产品。macaroonnetwork-mcp 是该网络的 MCP 发现路由客户端，帮助调用方浏览目录与元数据并完成购买。
用途 该 MCP 客户端用于在实时市场中按自然语言意图查找可售产品，并获取相关免费元数据；对需要付费的产品，则通过 x402 支付通道完成按次购买，并返回经过谓词校验的结果与收据。
主要能力（工具） macaroons_search：按自然语言意图搜索可售产品。免费。 macaroons_metadata：获取某个 feed 目标的免费新鲜度与内容哈希元数据。 macaroons_categories：获取规范分类注册表及精确映射的产品数量。免费。 macaroons_discover_mcp：获取有证据支持的实时 Macaroon MCP 服务器及其传输方式。免费。 macaroons_sources：获取经审核的来源与权利记录，并明确报告部分覆盖情况。免费。 macaroons_execute：执行一个 x402 USDC 产品，并获得谓词校验后的结果与收据。
使用方式 注册表：默认注册表为 https://api.macaroonnetwork.com 。本地开发可通过环境变量 MACAROONS_REGISTRY_URL 覆盖。 以 x402 支付：当产品需要付费时，macaroons_execute 会返回 x402_payment_required 结果，而不是隐藏挑战。调用方需用自己的钱包或 Coinbase CDP 基础设施对挑战中描述的精确支付进行签名，然后以相同参数再次调用 macaroons_execute 并附上 payment_signature。x402 精确结算采用一次签名重试，不存在轮询发票的流程。 设计约束：该包从不持有钱包，也不签名支付；它返回精确的 x402 挑战，由调用方自己的钱包基础设施签名，并在重试时接受该签名证明。
适用场景 适用于希望通过 MCP 客户端接入 Macaroon Network 的 AI 智能体或开发者，在需要基于证据、按查询付费的科学与数据市场中检索产品、查看分类与来源记录，并完成按次付费执行。
限制 本版本暴露的支付通道为 Base 主网上的 USDC（x402）；资料同时提到该网络支持 Bitcoin Lightning（L402）支付，但本发布所暴露的通道为 x402。该客户端不提供钱包托管或替调用方签名支付的能力，支付签名须由调用方自行完成。
