# Paddock (remote · paddock.finance)

Pre-payment verification for AI agents.

- Trust score: 81/100 (high trust)
- Change this week: +4
- Registry status: active
- Liveness: live
- Owner verified: no
- Last scored: 2026-10-25

## Components

- remote · `paddock.finance`: 81/100 (this document), [markdown](https://verifymcp.io/servers/finance-paddock-paddock/api-mcp-mcp.md), [page](https://verifymcp.io/servers/finance-paddock-paddock/api-mcp-mcp)

## Channel facts

- Endpoint: `https://paddock.finance/api/mcp/mcp`
- Transports: `streamable-http`
- Auth: `none`
- Version: `3.6.0`

## Trust breakdown

How this component scores in each security and reliability category. Every signal is checked automatically against the live server, and we only credit what we can confirm. Scores are 0–100 per category. Scoring method: https://verifymcp.io/docs/scoring (what has changed: https://verifymcp.io/docs/scoring/changelog)

Scored 2026-10-25.

- **Endpoint Security**: 80/100
  - The endpoint's TLS certificate is valid, in date, and uses a strong key.
  - No authorisation is required to call this server. Every tool declares its destructiveHint and none is destructive, so open access doesn't expose one.
  - HTTPS is enforced; there's no plaintext access path.
  - The HSTS (Strict-Transport-Security) header is present.
  - DNSSEC check failed: this domain isn't protected by DNSSEC.
- **Transport & Reachability**: 100/100
  - Verified streamable-http transport via a live MCP handshake.
- **Schema Quality & AI Usability**: 64/100
  - AI-judged instruction clarity (excellent).
  - Context-footprint check failed: tool/resource definitions use about 3465 tokens (~266/item across 13 items; 13 tools + 0 resources), over budget; trim descriptions and params.
  - Usage-examples check failed: none of the tools include examples.
- **Stability & Change Management**: 77/100
  - Stability observed for 23 of 30 days with no destabilising changes; credit accrues until the full window elapses.
- **Tool Coverage**: 100/100
  - 100% of tools have a non-trivial description (not blank, and not just the tool's name).
  - 100% of tool parameters carry a description.
- **Tool Safety**: 75/100
  - No prompt-injection markers were found in the server instructions, tool names or descriptions we captured.
  - 0 of 1 tool(s) whose name or description implies an irreversible operation declare an MCP destructiveHint annotation; "verify_before_pay" implies "pay" and declares readOnlyHint instead, contradicting what its own name says it does.
  - An AI judge read all 14 captured unit(s) of tool text and found none that tries to manipulate the model reading it.
- **Capabilities**: 100/100
  - Implements a supported MCP spec version (2025-11-25); the latest is 2026-07-28.

## Install

### How do I install the Paddock MCP server?

Paddock is a hosted endpoint at https://paddock.finance/api/mcp/mcp, so there is nothing to install locally. Ready-made configuration for Claude, Cursor, VS Code, Codex and 5 more is on this page, copied from each client's own documentation.

### Claude

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

### Cursor

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

### VS Code

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

### Codex

```toml
[mcp_servers.finance-paddock-paddock]
url = "https://paddock.finance/api/mcp/mcp"
```

### opencode

```json
{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "finance-paddock-paddock": {
      "type": "remote",
      "url": "https://paddock.finance/api/mcp/mcp",
      "enabled": true
    }
  }
}
```

### OpenClaw

```bash
openclaw mcp add finance-paddock-paddock --url 'https://paddock.finance/api/mcp/mcp' --transport streamable-http
```

### Hermes

```yaml
mcp_servers:
  finance-paddock-paddock:
    url: "https://paddock.finance/api/mcp/mcp"
```

### Netclaw

```json
{
  "McpServers": {
    "finance-paddock-paddock": {
      "Transport": "http",
      "Url": "https://paddock.finance/api/mcp/mcp"
    }
  }
}
```

### Vellum

```bash
assistant mcp add finance-paddock-paddock -t streamable-http -u 'https://paddock.finance/api/mcp/mcp'
```

### Other

```json
{
  "mcpServers": {
    "finance-paddock-paddock": {
      "type": "http",
      "url": "https://paddock.finance/api/mcp/mcp"
    }
  }
}
```

The mcpServers block is a cross-client convention. Remote transports vary, so check your client's docs.

## Changelog

Every change recorded for this component, newest first. Days that predate change tracking, or that we cannot explain, say so: "we were watching and nothing happened" and "we were not watching" are different claims.

### 2026-10-25 (score 81, +1)

No change was recorded against any check on this day. Stability & Change Management went from 73 to 77. That category is still filling its 30-day observation window: 22 days of observed history at the previous scan, 23 at this one. The score rises as the window fills, whether or not the server changes.

### 2026-10-23 (score 80, +1)

No change was recorded against any check on this day. Stability & Change Management went from 67 to 70. That category is still filling its 30-day observation window: 20 days of observed history at the previous scan, 21 at this one. The score rises as the window fills, whether or not the server changes.

### 2026-10-21 (score 79, +1)

No change was recorded against any check on this day. Stability & Change Management went from 60 to 63. That category is still filling its 30-day observation window: 18 days of observed history at the previous scan, 19 at this one. The score rises as the window fills, whether or not the server changes.

### 2026-10-19 (score 78, +1)

No change was recorded against any check on this day. Stability & Change Management went from 53 to 57. That category is still filling its 30-day observation window: 16 days of observed history at the previous scan, 17 at this one. The score rises as the window fills, whether or not the server changes.

### 2026-10-16 (score 77, +1)

No change was recorded against any check on this day. Stability & Change Management went from 43 to 47. That category is still filling its 30-day observation window: 13 days of observed history at the previous scan, 14 at this one. The score rises as the window fills, whether or not the server changes.

### 2026-10-14 (score 76, +1)

No change was recorded against any check on this day. Stability & Change Management went from 37 to 40. That category is still filling its 30-day observation window: 11 days of observed history at the previous scan, 12 at this one. The score rises as the window fills, whether or not the server changes.

### 2026-10-12 (score 75, +1)

No change was recorded against any check on this day. Stability & Change Management went from 27 to 33. That category is still filling its 30-day observation window: 8 days of observed history at the previous scan, 10 at this one. The score rises as the window fills, whether or not the server changes.

### 2026-10-10 (score 74, +2)

No change was recorded against any check on this day. Stability & Change Management went from 17 to 27. That category is still filling its 30-day observation window: 5 days of observed history at the previous scan, 8 at this one. The score rises as the window fills, whether or not the server changes.

## MCP tools (13)

### `verify_before_pay` (~904 tokens)

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 unpaid GET and POST at query time decode the 402 from the body AND the payment-required header; HTTP 200 is never treated as live. A contract mismatch is route:false and names the field (network, asset, seller, price). Includes independent paid-fulfillment results where available — whether a third party has actually paid this endpoint and got a valid response back, with the settlement hash. Test the result with route === true: the string "inconclusive" is truthy, and it is the one case where you must not pay on our say-so. The bias is deliberate: where evidence is incomplete, verify_before_pay favors inconclusive over a false pass — it will more often decline to clear a good endpoint than clear a bad one. route: true means the live contract matched your expectations — it is not an all-clear on every signal: stale settlement, a circular flag, a payTo divergence, and a failed request pre-flight can each coexist with it, so read the checks block rather than route alone. route_state carries the same verdict as route, always as a string ("true", "false", "inconclusive"), for clients that cannot type a boolean-or-string field. contract_and_request_ok is the narrower combined verdict: true only when route is true AND your own declared request passed pre-flight, false when either is bad, and the string "not_assessed" when a term was never established (usually because you passed no intended_params). Test it with === true; contract_and_request_ok_excludes names the risk categories it is silent on. No success-rate field is returned, deliberately: Paddock observes settlements, not failed calls, so recency and frequency are reported instead. Pass attest: true to also issue a signed, publicly fetchable reco…

Input parameters:

- `api_key` (string): Paddock API key. A free key (pk_free_) is enough for this tool — POST an email to paddock.finance/api/keys/free to get one. Builder/Pro Agent keys also work.
- `attest` (boolean): Also issue a signed, publicly fetchable record of this verdict. Returns an attestation id and a URL a third party can verify independently against Paddock's published key.
- `endpoint_url` (string): The resource URL your agent is about to pay, e.g. 'https://api.example.com/x402/search'. This is what gets probed.
- `expect_asset` (string): Asset contract address you expect, e.g. Base USDC. A mismatch returns route:false.
- `expect_network` (string): Network you expect, e.g. 'eip155:8453' or 'base'. A mismatch returns route:false.
- `expect_price_usdc` (number): Price in dollars you expect to pay, e.g. 0.01. Any difference returns route:false and names the field.
- `expect_seller` (string): Seller domain you expect, e.g. 'api.example.com'. A mismatch returns route:false.
- `intended_params` (string): Parameter NAMES your request will carry, comma-separated or as a query string, e.g. 'slug,limit' or '?slug=amazon-us'. Values are discarded. Checked against the schema the 402 declares; a missing req…
- `intended_params_empty` (boolean): Set true if your paid request will carry NO parameters at all. That is an assertion and it is checked: against a challenge that declares anything required, an empty request fails pre-flight. Omitting…
- `pay_to` (string): The recipient wallet from the 402 you are about to settle. CHECKED against the live challenge: if this endpoint is not currently asking to be paid at that wallet, route is false. Give this, endpoint_…

### `check_payee` (~281 tokens)

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 returns pass, warn, fail or unknown. Only fail recommends blocking. Free without a key up to 25 checks a day, or 1000 a day with a free key. For a full check against the seller's live payment terms, use verify_before_pay. Past the free limits, $0.01 per call over x402.

Input parameters:

- `amount_atomic` (string): Amount in atomic units
- `api_key` (string): Paddock API key. A free key (pk_free_) is enough for this tool — POST an email to paddock.finance/api/keys/free to get one. Builder/Pro Agent keys also work.
- `asset` (string): Token address. Echoed back, not checked
- `network` (string, required): CAIP-2 or x402 friendly name, e.g. eip155:8453, base, solana
- `pay_to` (string, required): The payee wallet from the payment requirements
- `url` (string, required): The resource URL the agent is about to pay

### `get_market_summary` (~111 tokens)

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 (attributed) transactions — named categories only, NOT a share of the full-ecosystem daily_transactions total; only the top 6 are returned, so the shown shares sum to <100% by design.

### `get_liveness` (~231 tokens)

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 probes that succeeded, latency p50/p95, sample counts, and last-probe time — including domains with no payment history at all. Sourced from an independent third-party monitoring feed, captured NIGHTLY: this is a daily series, not a live probe — for a check taken at query time use verify_before_pay. up is 7-day share of probes that succeeded >= 0.95 across every probed endpoint on the domain.

Input parameters:

- `api_key` (string): Optional Paddock API key (Builder/Pro Agent subscription). Omit to use the free trial (1 call/day) or to see x402 pay-per-query payment details.
- `domain` (string, required): Service domain to look up, e.g. 'api.example.com'

### `get_circular_signal` (~177 tokens)

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, self-funding percentage, detection date. Methodology public (v0.1). Patterns attach to the facilitator only — no seller wallet addresses, operator identity, or per-wallet rows are ever returned.

Input parameters:

- `api_key` (string): Optional Paddock API key (Builder/Pro Agent subscription). Omit to use the free trial (1 call/day) or to see x402 pay-per-query payment details.
- `window` (string): Reporting window for the trend context (default 30d).

### `get_best_value_provider` (~203 tokens)

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), and price, returning every input so the score can be checked. The composite formula is published in the route and in the docs, and Paddock does not sell positions in this ranking. Valid categories: llm, data, search, infra, content, markets, payments, comms (aliases accepted).

Input parameters:

- `api_key` (string): Optional Paddock API key (Builder/Pro Agent subscription). Omit to use the free trial (1 call/day) or to see x402 pay-per-query payment details.
- `category` (string, required): Category name, e.g. 'llm', 'data', 'markets'

### `get_category_detail` (~196 tokens)

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 categories: llm, data, search, infra, content, markets, payments, comms. Accepts common aliases (e.g. 'LLM inference' -> llm, 'scraping' -> data, 'trading' -> markets, 'defi' -> markets).

Input parameters:

- `api_key` (string): Paddock API key. A free key (pk_free_) is enough for this tool — POST an email to paddock.finance/api/keys/free to get one. Builder/Pro Agent keys also work.
- `category` (string, required): Category name, e.g. 'llm', 'data', 'markets'

### `get_niche_gaps` (~167 tokens)

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), with concentration and an Open/Tightening/Consolidating/Mature signal, and the published thresholds behind that label.

Input parameters:

- `api_key` (string): Optional Paddock API key (Builder/Pro Agent subscription). Omit to use the free trial (1 call/day) or to see x402 pay-per-query payment details.
- `top` (integer): Optional: return only the top N categories by opportunity_score (1-50).

### `get_changes` (~154 tokens)

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, with the figures on both sides.

Input parameters:

- `api_key` (string): Optional Paddock API key (Builder/Pro Agent subscription). Omit to use the free trial (1 call/day) or to see x402 pay-per-query payment details.
- `since` (string, required): Comparison date in YYYY-MM-DD format, earlier than today (UTC), max 90 days back.

### `get_whale_activity` (~172 tokens)

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. Size and where, never who — no individual seller identity is returned.

Input parameters:

- `api_key` (string): Optional Paddock API key (Builder/Pro Agent subscription). Omit to use the free trial (1 call/day) or to see x402 pay-per-query payment details.
- `min_usd` (number): Large-settlement threshold in USD (default 1000).
- `window` (integer): Mover comparison window in days (1-90, default 7).

### `get_token_metrics` (~312 tokens)

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 public /charts page reads — queryable by metric and date range. Metrics: spend_share_over_time, daily_transactions, category_concentration, new_services, liveness_score, aci. The aci metric returns the Agent Commerce Index series, which is SUSPENDED (ADR 0006): existing prints are retained and served, no new prints are computed, so that series does not advance. This is Paddock's series, not token prices; third-party token market data is deliberately not resold here.

Input parameters:

- `api_key` (string): Optional Paddock API key (Builder/Pro Agent subscription). Omit to use the free trial (1 call/day) or to see x402 pay-per-query payment details.
- `category` (string): Category id for category_concentration (e.g. 'llm').
- `days` (integer): Lookback window in days for the chart series (1-730, default 90).
- `from` (string): Start month YYYY-MM (aci metric only).
- `metric` (string, required): Which series to return.
- `to` (string): End month YYYY-MM (aci metric only).

### `get_provider_revenue` (~268 tokens)

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 only, never the full-ecosystem census: facilitator pass-through and circular-flagged wallets are excluded from the leaderboard; unresolved wallets are not dropped — they surface as one explicit unattributed row (transaction share only, no dollar figure exists for them). Also reports whether the recipient list was complete on every aggregated day, and flags (retroactive_exclusion_caveat) any day before 2026-07-28 where a wallet added to the exclusion lists afterward could not be retroactively re-checked.

Input parameters:

- `api_key` (string): Optional Paddock API key (Builder/Pro Agent subscription). Omit to use the free trial (1 call/day) or to see x402 pay-per-query payment details.
- `top` (integer): Return only the top N providers by revenue_usd (1-100, default 20).
- `window` (integer): Days to aggregate (1-90, default 7).

### `get_report_data` (~209 tokens)

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 trends, category breakdowns, protocol comparison and reliability. Any Agent Commerce Index (ACI) block is a retained historical print — the index is suspended (ADR 0006) and no new prints are computed. Free metadata (title, TOC, executive summary excerpt) is available without payment at /api/mcp/report-data.

Input parameters:

- `api_key` (string): Optional Paddock API key (Builder/Pro Agent subscription). Omit to use the free trial (1 call/day) or to see x402 pay-per-query payment details.
- `month` (string): Optional report month in YYYY-MM format (e.g. 2026-06). Defaults to the latest published month.

## Diagnostics

Captured diagnostic sections: TLS, DNSSEC, Authorisation, Transports. The full working is on the page: https://verifymcp.io/servers/finance-paddock-paddock/api-mcp-mcp#diagnostics

## Score history

- 2026-10-25: 81
- 2026-10-24: 80
- 2026-10-23: 80
- 2026-10-22: 79
- 2026-10-21: 79
- 2026-10-20: 78
- 2026-10-19: 78
- 2026-10-18: 77
- 2026-10-17: 77
- 2026-10-16: 77
- 2026-10-15: 76
- 2026-10-14: 76
- 2026-10-13: 75
- 2026-10-12: 75
- 2026-10-10: 74
- 2026-10-07: 72
- 2026-10-05: 72
- 2026-10-04: 71
- 2026-10-03: 71
- 2026-10-02: 70

## Common questions

### What is the Paddock MCP server?

Paddock is an MCP server listed in the public MCP registry as finance.paddock/paddock. Pre-payment verification for AI agents. This page covers its hosted endpoint (https://paddock.finance/api/mcp/mcp).

### Is the Paddock MCP server safe to use?

Paddock scores 81 out of 100 on VerifyMCP. That is a record of what we were able to check automatically, not an endorsement. The category breakdown on this page shows every signal behind the number, including the ones we could not confirm.

### What tools does the Paddock MCP server expose?

Paddock exposes 13 tools: verify_before_pay, check_payee, get_market_summary, get_liveness, get_circular_signal, and 8 more. Their descriptions and schemas cost roughly 3,385 tokens of context every time the server is loaded.

### Does the Paddock MCP server require authentication?

No. We connected to Paddock without credentials and it answered, so anything it exposes is reachable by anyone who knows the address.

### Is the Paddock MCP server still maintained?

Paddock is still listed as active in the MCP registry. We last reached this channel on 25 October 2026. Those dates come from our own scans of the registry and the channel itself, not from anything the publisher announced.

## Links

- Remote endpoint: https://paddock.finance/api/mcp/mcp
- Repository: https://github.com/unblinkr/paddock-mcp
- Website: https://paddock.finance/
- Changelog RSS feed: https://verifymcp.io/servers/finance-paddock-paddock/api-mcp-mcp.xml
- Changelog JSON feed: https://verifymcp.io/servers/finance-paddock-paddock/api-mcp-mcp.json
- HTML version of this page: https://verifymcp.io/servers/finance-paddock-paddock/api-mcp-mcp