Paddock

Name: Paddock
Author: unblinkr

作者：unblinkr版本 3.6.0i★ –i在云端运行

注册名称finance.paddock/paddock

安装

概览

作者提供的说明（英文原文）

Pre-payment verification for AI agents.

PopNx MCP 的三大支柱

这三项永远不会合并成一个分数：意见、测量和人气是不同的东西。

用户评价i暂无评价评价功能将在后续阶段与账户功能一起开放
我们的基础检查i3 项中通过 3 项依据公开信息检查；尚未扫描代码
使用情况i非常新★ –

它能帮你做什么

我们还没有为它写通俗的介绍。下面是我们从注册中心读取到的事实。

连接方式: 在云端运行
传输方式: Streamable HTTP
分类: 网店与支付

安装

选择你使用的 AI 应用，然后复制设置。

安装之前

基础检查：3 项中通过 3 项
在作者的服务器上运行：你向它提出的内容会经过他们的服务器。
可以做 13 件事（工具） verify_before_pay, check_payee, get_market_summary, get_liveness …
注册中心没有列出需要填写的密钥。

你需要

在云端运行无需安装任何东西，通过互联网连接

你用的是哪个应用？

ClaudeClaude CodeCursorVS CodeChatGPT

在上方选择你的应用。我们会记住它，下次按钮会显示“安装到 …”。

适用于网页版、桌面版和手机版 Claude：

打开 Settings → Connectors
点击 Add custom connector
粘贴下面的地址，然后点击 Add
如果要求登录，请登录作者的服务

https://paddock.finance/api/mcp/mcp

在终端中运行这条命令

claude mcp add --transport http paddock https://paddock.finance/api/mcp/mcp

在 Cursor 中打开

或者自己复制设置

粘贴到项目中的 .cursor/mcp.json，或 ~/.cursor/mcp.json

{
  "mcpServers": {
    "paddock": {
      "url": "https://paddock.finance/api/mcp/mcp"
    }
  }
}

浏览器会先询问是否打开应用，然后应用会显示设置并请你确认。密钥的值会留空，由你自己填写。

在 VS Code 中打开

或者自己复制设置

粘贴到项目中的 .vscode/mcp.json

{
  "servers": {
    "paddock": {
      "type": "http",
      "url": "https://paddock.finance/api/mcp/mcp"
    }
  }
}

浏览器会先询问是否打开应用，然后应用会显示设置并请你确认。密钥的值会留空，由你自己填写。

ChatGPT 只能连接互联网上的服务器：

打开网页版 ChatGPT → Settings → Connectors (Apps)
点击 Create 或 Add（部分套餐需要先在 Advanced 中开启 Developer mode）
粘贴下面的地址，起个名字，然后保存
如果要求登录，请登录作者的服务

https://paddock.finance/api/mcp/mcp

菜单名称可能因套餐和版本不同而略有差异。

你的选择通过 Cookie 保存在这台设备上，无需账户。

这些设置是根据作者在注册中心的条目生成的。如果 README 的写法不同，请以 README 为准。

它能做什么

工具名称和描述与服务器在 2026年11月8日报告的完全一致。这些内容由作者撰写，不是我们写的；我们以纯文本形式显示。

verify_before_pay
Should my agent pay this endpoint right now? Free key - a free pk_free_ key covers it against a shared 10 calls/day; $0.25 per call via x402 beyond it. Over MCP only, 1 free trial call/day is available without a key. CALL THIS BEFORE YOUR AGENT AUTHORIZES ANY x402 PAYMENT. An unp
check_payee
Is this the seller's wallet, before my agent pays it? Fast payee check before an agent pays. Send the resource URL and the payment terms you are about to sign: payee wallet, network and amount. Paddock answers from its daily settlement record in one call, with no live probe, and
get_market_summary
How big is agent commerce today? (The citation number.) Keyless - no key, no payment, no rate limit. Returns daily transactions, USDC spend, unique buyer agents, live providers, and top categories by share. Each category's share_of_transactions is its share of CATEGORIZED (attrib
get_liveness
Was this domain up at last night's probe, per someone who isn't the seller? Free key - a free pk_free_ key covers it against a shared 10 calls/day; $0.001 per call via x402 beyond it. Over MCP only, 1 free trial call/day is available without a key. Per-domain 7-day share of probe
get_circular_signal
Is this facilitator's volume real, or is it paying itself? Paid - $0.99 per call via x402, or a Builder / Pro Agent key. Over MCP only, 1 free trial call/day is available without a key. Wash/circular-settlement signal per facilitator: flagged clusters, flagged volume and share, s
get_best_value_provider
Which provider in this category should my agent pick? Paid - $0.02 per call via x402, or a Builder / Pro Agent key. Over MCP only, 1 free trial call/day is available without a key. Ranks a category by reliability (7-day share of probes that succeeded), reputation (unique buyers),
get_category_detail
Who's selling in this category, and who's actually getting paid? Free key - a free pk_free_ key covers it against a shared 10 calls/day. Every service in a category with daily transactions, USDC volume, unique buyers, and reliability score, from the nightly snapshot. Valid catego
get_niche_gaps
Where is demand outrunning supply? Free key - a free pk_free_ key covers it against a shared 10 calls/day; $0.01 per call via x402 beyond it. Over MCP only, 1 free trial call/day is available without a key. Every category ranked by opportunity score (high volume, few providers),
get_changes
What changed since a date I name? Paid - $0.10 per call via x402, or a Builder / Pro Agent key. Over MCP only, 1 free trial call/day is available without a key. Diffs today against any snapshot up to 90 days back — new services, retired services, category share shifts, top movers
get_whale_activity
Where did the large settlements go? Paid - $0.99 per call via x402, or a Builder / Pro Agent key. Over MCP only, 1 free trial call/day is available without a key. Large settlements over a window, aggregated by facilitator, category and size band, plus per-category mover counts. S
get_token_metrics
Is today's number a real move or ordinary noise? Free key - a free pk_free_ key covers it against a shared 10 calls/day; $0.01 per call via x402 beyond it. Over MCP only, 1 free trial call/day is available without a key. Paddock's own first-party series — the same chart data the
get_provider_revenue
Who earns the most, and how much of the market can that answer see? Paid - $0.99 per call via x402, or a Builder / Pro Agent key. Over MCP only, 1 free trial call/day is available without a key. Resolved by payTo wallet attribution, not by counting events. ATTRIBUTED universe onl
get_report_data
What are the numbers behind the monthly report? Paid - $0.99 per call via x402, or a Builder / Pro Agent key. Metadata is free. No free trial on this tool. The monthly State of Agent Commerce as structured JSON: every figure with its universe label and methodology version, plus t

基础检查i

我们检查的是任何人都能看到的信息；我们没有阅读代码。不适用的检查项不计入总数。 · 检查于 2026年11月9日

✓ 通过
作者与仓库一致
注册名称已通过域名 paddock.finance 验证（注册中心会核实域名所有权）
… 尚未检查
仍在维护
我们还没有从 GitHub 读取这个仓库
… 尚未检查
有许可证
我们还没有从 GitHub 读取这个仓库
✓ 通过
端点有响应
在 262 毫秒内响应（HTTP 200）
– 不适用
使用 OAuth 登录
无需登录
✓ 通过
工具描述中没有隐藏指令
已读取 13 个工具描述，未发现针对 AI 的隐藏指令

与“网店与支付”中的其他服务器比较i

星标数多于此分类中其他 2570 个服务器的 0%
发布到注册中心的时间比此分类中其他 2570 个服务器的 44% 更新
基础检查结果等于或优于此分类中其他 2570 个服务器的 100%

与注册中心里这个分类中所有活跃的服务器比较。只有当发布者拥有该仓库时，星标数才计入。

常见问题

Paddock 安全吗？

它在 3 项适用的基础检查中通过了 3 项。我们没有阅读代码。在添加密钥或令牌之前，请先看看这个服务器要求哪些权限，并使用只具备所需权限的密钥。

它需要哪些密钥或代码？

注册中心没有列出必需的密钥，不过有些服务器会在首次使用时要求你登录。

它在我的电脑上运行还是在云端？

它在作者的云端运行。通过互联网连接，无需安装，但你发送的内容会经过作者的服务器。

它还在维护吗？

GitHub 仓库最后更新于–，最新版本（3.6.0）于37天前进入注册中心。

哪些应用可以使用它？

支持 MCP 的应用，例如 Claude Desktop、Claude Code、Cursor 和 VS Code。它通过 URL 连接，所以接受远程 MCP 服务器的应用也可以使用，例如开启开发者模式的 ChatGPT。

有什么可以替代它？

同一分类中有：Spree Commerce: open-source B2B and marketplace ecommerce, Stripe MCP, MCP Cn Commerce

替代选择

同一分类中其他作者的服务器，按星标数排序。

如何看卡片：↓ 每周下载量i★ GitHub 星标i三大支柱：评价 · 检查 · 使用情况i更新 = 最新版本发布到注册中心的时间i

Spree Commerce: open-source B2B and marketplace ecommerce

Open-source B2B and marketplace ecommerce; new stores include an MCP server for AI agents.

作者：spree广泛使用★ 1.6万9天前更新

在云端运行

安装

Stripe MCP

MCP server integrating with Stripe - tools for customers, products, payments, and more.

作者：stripe广泛使用★ 204313个月前更新

在云端运行✓ stripe.com

安装

MCP Cn Commerce

8 read-only MCP platform entries; support is operation-specific; merchant live acceptance pending

作者：TonyWang-hub起步阶段↓ 73/周★ 9629天前更新

在你的电脑上运行

安装

作者的 README

打开 README

按原文从作者的仓库复制。PopNx MCP 没有审查或背书其内容。HTML、图片和脚本已被移除。链接会离开本站。

Paddock

Agent payments have no chargeback. Paddock is pre-payment verification for AI agents.

It checks that an x402 API is real, live, and fairly priced before your agent pays it, and it measures what AI agents actually pay each other on x402 across Base and Solana.

Paddock snapshots the live agent economy, transaction volume, spend, buyers, providers, category share, and reliability, and serves it through a set of MCP tools and an HTTP API that agents can call directly, paying per query with x402 or with a subscription key.

Note on `openapi.json`: The openapi.json in this repository is a byte-for-byte mirror of the live specification served at paddock.finance/openapi.json, which is generated from the site's route and is the source of truth. Both declare the same info.version (currently 3.8.0); if they ever disagree, the live specification is correct and this file is stale. Use either for tool discovery and client generation.

Why agents call it

Should I pay this endpoint right now? verify_before_pay probes the target live, checks the contract against what you expect and the seller's own published config, then adds settlement recency, the circular signal, and price versus market, before your agent authorizes a payment it cannot take back.
Find the best live provider. Rank providers in a category by a composite of reliability (7-day success rate), reputation (unique buyers), and price, so an agent can route to the strongest option, not just the cheapest.
Is this service still up? Per-domain liveness lookup, up/down, 7-day probe success rate, and latency, before an agent commits a paid call to a provider.
Where's demand moving? Diff today's snapshot against a past date to see new services, retired services, category share movements, and top movers, so an agent knows where spend is shifting.

The MCP tools

Twelve tools are live, across three access tiers. get_market_summary needs no authentication at all. Five tools are covered by a free key, 10 calls per UTC day, shared across all five, issued instantly from an email address. The rest are premium: a Paddock API key, an x402/MPP per-query payment, or one free trial call per day (where noted).

Tool	Price	Description
`verify_before_pay`	Free key, or $0.25 USDC / query	The pre-payment check no seller can self-report. Probes the target live for its 402, checks the contract against what you expect and the seller's own published config, then adds settlement recency, the circular signal, and price versus market. Returns `route` true/false/inconclusive, each with dated evidence. Call this before your agent authorizes any x402 payment.
`get_market_summary`	Free	Current AI agent commerce market overview: total daily transaction volume, USDC spend, unique buyer agents, live service providers, and the top spending categories with their share of volume.
`get_category_detail`	Free key	All services in a specific category (`llm`, `data`, `search`, `infra`, `content`, `markets`, `payments`, `comms`; aliases accepted) with transaction counts, pricing, provider count, and reliability scores.
`get_niche_gaps`	Free key, or $0.01 USDC / query	Ranks every category by `opportunity_score` (high volume, few providers) with share, top-provider concentration, and an Open/Tightening/Consolidating/Mature signal. Answers "where should I build an x402 service?"
`get_best_value_provider`	$0.02 USDC / query	Ranks providers in one category by a composite of reliability (7-day success rate), reputation (unique buyers), and price.
`get_liveness`	Free key, or $0.001 USDC / query	Per-domain liveness for any domain TrustBench probes, with full probe detail: up/down (7-day probe success rate >= 0.95), score, latency p50/p95, sample count, endpoint count, and last-probe time. Reads the same nightly rollup as `get_category_detail`; the difference is reach and depth, not freshness, it answers for domains that have no x402 volume at all, which the category tool cannot.
`get_changes`	$0.10 USDC / query	Diffs today's market snapshot against a past date (up to 90 days back): new services, retired services, category share movements, and top movers.
`get_circular_signal`	$0.99 USDC / query	Wash/circular-settlement signal, aggregate per facilitator: cluster count, cluster volume (30d/7d), self-funding %, external-payer count, flagged share of settlement, and trend. Aggregate only, no wallet addresses or operator identity.
`get_whale_activity`	$0.99 USDC / query	Large settlements and movers over a window, aggregate by facilitator, category, and size band: amounts, counts, and per-category mover counts. Describes size and where, never who.
`get_token_metrics`	Free key, or $0.01 USDC / query	First-party chart/time-series data by metric and date range: spend share over time, daily transactions, category concentration, new services, liveness score, and the Agent Commerce Index (ACI).
`get_provider_revenue`	$0.99 USDC / query	Which providers earn the most over a window of daily snapshots, and how much of the market that answer can see. Attributed universe only, facilitator pass-through and circular-flagged wallets are excluded, and unresolved wallets are not dropped but surface as one explicit `unattributed` row (transaction share only; no dollar figure exists for them). Reports whether the recipient list was complete on every aggregated day.
`get_report_data`	Free metadata + $0.99 USDC / query for full data	Free metadata (title, table of contents, executive summary excerpt) at the unauthenticated `/api/paddock/mcp/report-data` route; full structured JSON of the monthly State of Agent Commerce report, ecosystem trends, category breakdowns, the Agent Commerce Index (ACI) with component decomposition, protocol comparison, and reliability data, via the x402-hardened `/api/paddock/mcp/report-data/paid` route.

The paid tools (verify_before_pay, get_niche_gaps, get_best_value_provider, get_liveness, get_changes, get_circular_signal, get_whale_activity, get_token_metrics, get_provider_revenue) each allow one free trial call per day per IP. get_report_data has no free trial on the full-data route; only its metadata is free.

get_report_data is published with two paths. The free-metadata route (/api/paddock/mcp/report-data) is declared with security: [] and is deliberately excluded from x402scan indexing; the full-data route (/api/paddock/mcp/report-data/paid) carries the x402 payment scheme. Both are visible in openapi.json.

Signed attestations

Paddock can emit a signed attestation for any pre-payment check: a portable JSON record carrying the observed payment terms, the settlement history it was checked against, the observation window, and the verdict, signed Ed25519 over an RFC 8785 canonical form. The signing key is published at a well-known path, and records verify standalone with no API access and no trust in Paddock. This is the attested-evidence format proposed for the x402 dispute-resolution extension.

The public key path: /.well-known/paddock-attestation-key
Verify it yourself: fetch the record, canonicalize per RFC 8785, check the Ed25519 signature against the published key.
Live example: https://paddock.finance/a/mFxHpIcBGHR0NsmkpT8rHb0wvX_8tIr3K0xOl_4W4UY

Connecting from Claude Desktop

In Claude Desktop, open Settings → Connectors → Add custom connector, then paste the Paddock MCP URL below. Claude discovers the tools automatically.

https://paddock.finance/api/mcp/mcp

The free tools work over the connector with no authentication. The paid tools work over the connector too: pass your Paddock API key as the api_key argument on the tool call and the server forwards it as the X-Paddock-Key header, billing the call against your subscription. Omit api_key to use the once-per-day free trial, or to settle the tool's USDC price via x402 pay-per-query.

Connecting from other MCP clients

Paddock exposes a standard MCP HTTP transport at the same URL: point any MCP-compatible client at it:

https://paddock.finance/api/mcp/mcp

For tool discovery, schemas, and the full route map, see openapi.json in this repository (mirrored to paddock.finance/openapi.json).

The free key

New here? [Build on Paddock](./BUILDING.md) is the walkthrough: 60-second start, what each free tool is actually good for, five worked examples, and how to size your usage. The rest of this README is reference.

get_market_summary is open to everyone with no key, no signup, and no rate limit. It is the citation surface. If you are quoting a Paddock figure, quote it from here.

Five more tools, verify_before_pay, get_category_detail, get_niche_gaps, get_token_metrics, get_liveness, are covered by a free key. One request gets you one:

curl -X POST https://paddock.finance/api/keys/free \

-H "Content-Type: application/json" \ -d '{"email":"you@example.com"}'

The key is returned in the response and emailed to you. Pass it as the X-Paddock-Key header, or as the api_key argument over the MCP connector.

10 calls per UTC day, shared across all five tools, one counter, not 10 each.
Every successful response carries a usage object (used, limit, remaining, resets_at) so you can meter yourself.
Over the limit returns a structured 429 naming the reset time and both paid paths.
Premium tools are never on a free key. Calling one returns a structured 402 naming the price, and that refusal is not counted against your daily limit.

Free trial and free key are different. The free trial is 1 call per IP per day with no key at all, shared across the paid tools, a zero-friction taste, and it still works. The free key is the workflow tier above it, tied to your key rather than your IP.

Free for development and internal use. Redistribution, resale, or serving Paddock data to your end users requires a commercial license: see paddock.finance/api-access or contact hello@paddock.finance.

Pricing

Plan	Price	Limit
Keyless	Free	`get_market_summary`, unlimited, no key, no cap
Free key	Free	Five tools at 10 queries/day, shared, see The free key
Builder	$99/mo	10,000 queries/day
Pro Agent	$499/mo	Unlimited
x402 per-query	Pay per pull	Agent-native, no subscription, pay the per-tool USDC price at call time

The x402 per-query option is for agent-native, pay-per-pull access with no subscription: an agent settles the tool's USDC price at call time. To subscribe to Builder or Pro Agent and obtain an API key, see paddock.finance/api-access.

Authentication

Keys come in three classes and all travel the same way, in the X-Paddock-Key header: pk_free_ (free tier, five tools, 10/day shared), pk_builder_ ($99/mo) and pk_proagent_ ($499/mo). Paid tools accept a Builder or Pro Agent key; Send the key with each request and the call is billed against your subscription's daily quota. Over the MCP connector (e.g. in Claude), pass the key as the api_key tool argument instead; the server forwards it as X-Paddock-Key. Alternatively, agents can pay per query with x402: omit the key and settle the tool's USDC price via the x402 payment flow at call time. Free tools require neither.

Docs & contact

Canonical documentation: paddock.finance/docs
Questions: hello@paddock.finance
On X: @PaddockFinance

Status

Production. Snapshots written daily at 23:30 UTC.

Paddock

概览

PopNx MCP 的三大支柱

它能帮你做什么

安装

安装之前

它能做什么

基础检查i

作者与仓库一致

仍在维护

有许可证

端点有响应

使用 OAuth 登录

工具描述中没有隐藏指令

与“网店与支付”中的其他服务器比较i

常见问题

替代选择

Spree Commerce: open-source B2B and marketplace ecommerce

Stripe MCP

MCP Cn Commerce

作者的 README

Paddock

Why agents call it

The MCP tools

Signed attestations

Connecting from Claude Desktop

Connecting from other MCP clients

The free key

Pricing

Authentication

Docs & contact

Status