Receipts Index

receipts-index-mcp

用于 Receipts Index API 的 MCP 服务（通过 npm 使用 stdio，并提供远程 Streamable HTTP 端点）：https://api.receiptsindex.com/?utm_source=npm，由 Carter Enterprise LLC 发布。

Receipts Index 是 Namebeam 的记录，用于展示 AI 引擎针对固定买家问题提到的美国本地商家：每次检查、每个引擎和每个 UTC 日期对应一条带日期的记录（截至 2026-10-27，记录共 2,714 条，日期范围为 2026-07-29 至 2026-10-27）。

免费开始：使用 /v1/index 列出记录 ID 和日期，并通过 /v1/sample 读取一条真实记录。可通过哈希值验证已发布的 Namebeam 答案：https://namebeam.ai/verify/?utm_source=npm。然后使用 x402，以 Base 上的 USDC 购买记录：每条 0.27 USDC，每日文件 1.81 USDC。

此服务读取免费路由，并列出付费路由的价格。它不会付款，也不会签名。

工具

工具	调用	费用	返回内容
receipts_index	GET /v1/index	免费	记录 ID 和 UTC 日期（不含记录内容）、记录总数、最早和最晚日期，以及有记录的日期。可选参数 start（整数，至少为 1）和 limit（整数，范围为 1 至 500）用于分页浏览记录 ID。
receipts_sample	GET /v1/sample	免费	一条标记为样本的真实记录、其记录 ID、该记录的付费路由和价格，以及以字段形式和 CSV 形式呈现的记录。无参数。
receipts_pricing	GET /.well-known/x402、GET /v1/manifest	免费	API 列出的付费端点及其 USDC 价格。

付费端点（按 API 所列）

付费路由使用 x402 和 Base 主网上的 USDC。记录和日期文件以带标题行的 CSV 格式返回。不存在的记录 ID 或日期会返回 404，且不会收费。

路由	价格（USDC）	返回内容
GET /v1/row/{row_id}	0.27	一条 CSV 记录
GET /v1/day/{YYYY-MM-DD}	1.81	某个 UTC 日期的所有记录
GET /v1/corpus	540	每次调用以一个 CSV 文件返回完整语料
GET /v1/feed/founding-partner	200	每次调用返回完整语料。标价为每月 200 USDC；按次调用计价

使用 receipts_index 选取有效的记录 ID 或日期，使用 receipts_sample 查看记录格式，然后通过任意 x402 客户端购买。此服务不包含钱包或支付客户端。价格在调用时从 API 读取，因此 receipts_pricing 提供当前价格。

记录字段：date_utc、check_id、business、niche、market、engine、prompt_variant、run、business_mentioned、competitors_named、sources_cited、run_channel、flags。

遥测

从 0.1.1 版本起，服务会通过 PostHog MCP Analytics 向 PostHog（Carter Enterprise LLC 的项目）发送匿名使用事件：每次工具调用（工具名称、客户端名称和版本、耗时、错误）对应一个事件，以及工具列表、握手过程和 Agent 在 context 参数中提供的简短原因。只会记录 start 和 limit 参数的值；你传入的其他内容均不会被记录。启用遥测后，每个工具都会接受 context 参数，服务还会添加一个 get_more_tools 工具，供 Agent 说明自己需要什么但未能找到。

在服务的环境中设置 RECEIPTS_INDEX_TELEMETRY=0 或 DO_NOT_TRACK=1 即可关闭遥测。关闭后不会创建 PostHog 客户端，工具也仅限于上述三个。

远程端点（Streamable HTTP）

URL：https://api.receiptsindex.com/mcp。自 2026-10-28 起可用（initialize、tools/list 和全部三个工具均已响应）。无需登录，无需密钥。

它提供与 stdio 服务相同的三个只读工具，无需登录，也无需 API 密钥。receipts_index 和 receipts_sample 返回免费数据。receipts_pricing 返回付费路由的 x402 付款条款（路由、USDC 价格、网络、收款地址）。端点不会付款，也不会签署任何内容；付款由 x402 客户端针对列出的路由完成。

将其添加到任何支持远程 MCP URL 的客户端（Claude 和 ChatGPT 自定义连接器，或任何可通过 URL 添加 MCP 服务的助手）：

https://api.receiptsindex.com/mcp

协议说明：无状态 Streamable HTTP，JSON 响应。发送 POST JSON-RPC 消息（initialize、ping、tools/list、tools/call）；通知会收到 202。由于没有服务端发起的流，也没有会话，GET 和 DELETE 会返回 405。接受的协议版本为 2025-11-25、2025-06-18、2025-03-26 和 2024-11-05；不受支持的 MCP-Protocol-Version 标头会返回 400。CORS 开放（Access-Control-Allow-Origin: *），因为该端点不接收凭据，且提供公共数据。远程端点不会发送遥测数据。

curl -sS https://api.receiptsindex.com/mcp -H 'content-type: application/json' -H 'accept: application/json, text/event-stream' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

处理程序为 src/remote.ts（不依赖 SDK，仅使用 Fetch API）。运行 npm run build，再运行 node scripts/build-worker-module.mjs，会生成 dist/worker/mcp-remote.worker.js，这是粘贴到 Worker 中的单文件形式。test/remote.test.ts 会逐字段检查其工具列表是否与 stdio 服务一致。

安装

需要 Node.js 20.20 或更高版本（或 22.22 或更高版本）。

Claude Desktop 或任何读取 mcpServers 块的客户端：

{
  "mcpServers": {
    "receipts-index": {
      "command": "npx",
      "args": ["-y", "receipts-index-mcp"]
    }
  }
}

Claude Code：

claude mcp add receipts-index -- npx -y receipts-index-mcp

开发

npm install
npm test

测试使用 fixtures/ 中记录的固定样例（参见 fixtures/PROVENANCE.txt），不会发起网络请求。

限制

• 行内容、按日文件和语料库均为付费内容。免费工具仅返回 ID、日期、一行样例和价格。
• 数据记录的是所列日期中具名 AI 引擎给出的回答。数据不对引擎为何如此回答作出任何说明。
• 来源和联系方式：Carter Enterprise LLC，https://api.receiptsindex.com/?utm_source=npm。许可证：MIT。

Namebeam 是 Carter Enterprise 旗下产品。这是第一步。