Receipts Index

io.github.mrcrtr1979-droid由 GitHub 账号 mrcrtr1979-droid 发布v0.1.5更新于 Oct 29, 2026

Free index and sample of dated AI-engine answer rows; prices for paid x402 rows. Never pays.

已验证Streamable HTTP可网页运行金融数据与分析

概览

AI 生成的概览

以只读方式接入 Receipts Index API:浏览免费的行 ID 与日期、查看一条示例记录,并列出 x402 付费价格(USDC)。

可以做什么
  • 列出索引行:分页获取行 ID 与 UTC 日期、行数、首末日期以及有数据的日期
  • 读取一条示例记录行,标注为样本,含行 ID、付费路由与价格,并以字段和 CSV 形式返回
  • 读取定价:按 API 所列返回付费 x402 端点及其 USDC 价格
  • 不付款不签名:服务器只读取免费路由和付款条款
适用场景
适合让助手浏览 Receipts Index 中按日期记录的美国本地商家 AI 引擎回答行、了解单行数据结构,或在用独立 x402 客户端购买前查询付费行的价格。
运行要求
可使用远程 Streamable HTTP 端点(api.receiptsindex.com/mcp,无需登录或密钥),或通过 npx 运行本地 npm 包,后者需要 Node.js 20.20 或更高版本(或 22.22 或更高版本)。需要能访问 Receipts API 的网络。
安装前请注意
行内容、按日文件和全量语料需付费,通过 Base 上的 x402 以 USDC 单独购买(每行 0.27、每日文件 1.81、全量语料 540);服务器本身不付款也不签名,需另备钱包客户端。npm 本地服务器会向 PostHog 发送匿名使用事件,包括工具名、客户端名称与版本、耗时、错误以及代理在 context 中给出的简短原因;可用 RECEIPTS_INDEX_TELEMETRY=0 或 DO_NOT_TRACK=1 关闭。远程端点不发送遥测。

安装

在 SourceWeft 中

  1. 打开 控制台中的 Receipts Index,将其添加到工作区。
  2. 为需要使用其工具的对话启用该服务。

Web executable,通过 Streamable HTTP。 远程服务在工作区中配置后即可从网页运行时运行。

交给智能体安装

把这段提示词粘贴到 Claude Code、Codex、Cursor 等智能体,或 SourceWeft 对话中。智能体会读取该服务器的安装指南,先向你展示发布者、端点和登录方式,经你同意后再把它添加到你的客户端。密钥不会写进任何命令。

阅读 https://sourceweft.com/mcp/io.github.mrcrtr1979-droid%2Freceipts-index/install.md,并按其中说明把这个 MCP 服务器接入我的客户端。修改任何配置之前,先告诉我它的发布者、端点和登录方式,等我确认。不要把 API 密钥写进命令或我会提交的文件;问我密钥应从哪里获取。

查看智能体所依据的安装指南

其他 MCP 客户端

把它添加到你客户端的 mcpServers 配置中。

{
  "mcpServers": {
    "receipts-index": {
      "type": "http",
      "url": "https://api.receiptsindex.com/mcp"
    }
  }
}

README

receipts-index-mcp

An MCP server for the Receipts Index API (stdio through npm, and a remote Streamable HTTP endpoint) at https://api.receiptsindex.com/?utm_source=npm, published by Carter Enterprise LLC.

The Receipts Index is the Namebeam record of which US local businesses AI engines name for fixed buyer questions: one dated row per check, engine and UTC date (2,714 rows, 2026-07-29 to 2026-10-27 as read on 2026-10-27).

Start free: list row ids and dates with /v1/index and read one real row with /v1/sample. Published Namebeam answers can be checked by hash at https://namebeam.ai/verify/?utm_source=npm. Then buy rows over x402 in USDC on Base: 0.27 per row, 1.81 per day file.

This server reads the free routes and lists what the paid routes cost. It never pays and never signs anything.

Tools

ToolCallsCostReturns
receipts_indexGET /v1/indexfreeRow ids and UTC dates (no row content), row count, first and last date, the dates that have rows. Optional start (integer, 1 or more) and limit (integer, 1 to 500) page through row ids.
receipts_sampleGET /v1/samplefreeOne real record row labeled as a sample, its row id, the paid route and price for that row, the row as fields and as CSV. No parameters.
receipts_pricingGET /.well-known/x402, GET /v1/manifestfreeThe paid endpoints with prices in USDC, as the API lists them.

Paid endpoints (as listed by the API)

Paid routes use x402 with USDC on Base mainnet. Row and day files come back as CSV with a header line. A row id or date that does not exist returns 404 and is not charged.

RoutePrice (USDC)Returns
GET /v1/row/{row_id}0.27One CSV row
GET /v1/day/{YYYY-MM-DD}1.81All rows for one UTC date
GET /v1/corpus540The full corpus as one CSV, per call
GET /v1/feed/founding-partner200The full corpus per call. Listed at 200 USDC per month; access is priced per call

Use receipts_index to pick a valid row id or date, receipts_sample to see the row shape, then buy with any x402 client. This server does not include a wallet or a payment client. Prices are read from the API at call time, so receipts_pricing is the current source.

Row fields: date_utc, check_id, business, niche, market, engine, prompt_variant, run, business_mentioned, competitors_named, sources_cited, run_channel, flags.

Telemetry

From 0.1.1 the server sends anonymous usage events to PostHog (project of Carter Enterprise LLC) through PostHog MCP Analytics: one event per tool call (tool name, client name and version, duration, error), tool listings, the handshake, and the short reason the agent gives in the context argument. Only the start and limit argument values are recorded; nothing else you pass is recorded. With telemetry on, each tool takes a context argument and the server adds a get_more_tools tool where an agent can say what it needed and did not find.

Turn it off with RECEIPTS_INDEX_TELEMETRY=0 or DO_NOT_TRACK=1 in the server's environment. Off means no PostHog client is created and the tools are exactly the three above.

Remote endpoint (Streamable HTTP)

URL: https://api.receiptsindex.com/mcp. Live since 2026-10-28 (initialize, tools/list and all three tools answered). No sign-in, no key.

It exposes the same three tools as the stdio server, read-only, with no sign-in and no API key. receipts_index and receipts_sample return the free data. receipts_pricing returns the x402 payment terms for the paid routes (route, USDC price, network, pay-to address). The endpoint never pays and never signs anything; paying is done by an x402 client against the listed route.

Add it to any client that takes a remote MCP URL (Claude and ChatGPT custom connectors, or any assistant that can add an MCP server by URL):

https://api.receiptsindex.com/mcp

Protocol notes: stateless Streamable HTTP, JSON responses. POST a JSON-RPC message (initialize, ping, tools/list, tools/call); notifications get 202. GET and DELETE return 405 because there is no server-initiated stream and no session. Protocol versions 2025-11-25, 2025-06-18, 2025-03-26 and 2024-11-05 are accepted; an unsupported MCP-Protocol-Version header returns 400. CORS is open (Access-Control-Allow-Origin: *) because the endpoint takes no credentials and serves public data. The remote endpoint sends no telemetry.

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"}'

The handler is src/remote.ts (no SDK dependency, Fetch API only). npm run build plus node scripts/build-worker-module.mjs writes dist/worker/mcp-remote.worker.js, the single-file form that is pasted into the Worker. test/remote.test.ts checks that its tool list matches the stdio server's field by field.

Install

Requires Node.js 20.20 or newer (or 22.22 or newer).

Claude Desktop or any client that reads an mcpServers block:

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

Claude Code:

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

Develop

npm installnpm test

The tests run against recorded fixtures in fixtures/ (see fixtures/PROVENANCE.txt) and make no network calls.

Limits

  • Row content, day files and the corpus are paid. The free tools return ids, dates, one sample row and prices only.
  • The data is a record of what the named AI engines answered on the dates shown. It makes no claim about why an engine answered as it did.
  • Source and contact: Carter Enterprise LLC, https://api.receiptsindex.com/?utm_source=npm. License: MIT.

Namebeam, a Carter Enterprise property. This is the first leg.

来源:mcp/README.md,提交 0ae7baf

工具

3

receipts_index

Receipts Index: free row index

Calls GET /v1/index on the Receipts API. Free. Returns row ids and UTC dates (no row content), the row count, the first and last dates, and the list of dates that have rows. Use start and limit to page through row ids. Row content is sold per call through x402 and is not returned here.

输入参数limitstart

receipts_sample

Receipts Index: free sample row

Calls GET /v1/sample on the Receipts API. Free. Returns one real record row labeled as a sample, with its row id, the paid route and price for that row, and the row as fields and as CSV. It takes no parameters and is not a purchase.

无需输入参数。

receipts_pricing

Receipts Index: paid endpoints and prices

Reads GET /.well-known/x402 (and /v1/manifest for the price text) on the Receipts API and returns the paid endpoints with their prices in USDC. Free to call. It never pays and never signs anything. Paying is done by an x402 client against the listed route.

无需输入参数。

版本历史

1
  1. v0.1.5最新Oct 29, 2026

评分

已满足适用检查项的 100%

该评分衡量此收录条目的完整程度,依据注册中心条目、端点与公开来源计算得出。它不是对服务器本身的评价,也不表示服务器安全或当前可用:可连通性是带日期的检查结果,评分也不包含安装量或用户评价。

  • 近 30 天内可连通必需25 分
  • 已声明认证方式必需10 分
  • 已列出工具必需15 分
  • 描述必需15 分
  • 图标10 分
  • 文档15 分
  • 许可证10 分