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 分