Spree Commerce developer docs for AI agents
Spree Commerce docs for AI coding agents: build headless B2B and marketplace ecommerce on its APIs.
Beschreibung vom Entwickler (englisches Original)
Pre-payment verification for AI agents.
Für diesen Server haben wir noch keine Zusammenfassung in einfacher Sprache geschrieben. Unten stehen die Fakten, die wir aus der Registry gelesen haben.
Wähle die KI-App, die du nutzt, und kopiere die Einstellungen.
5/5 Prüfungen bestanden · Was du fragst, läuft über den Server des Anbieters (paddock.finance)
Zuerst: Welche KI nutzt du?
Wähle deine App, dann erscheinen die Schritte unten.
Klappt mit Claude · etwa 2 Min.
Kein Schlüssel, nichts zu installieren · Einmal auf claude.ai oder in der Desktop-App einrichten, dann im Chat nutzen · kostenlose Konten können 1 hinzufügen
CustomizeConnectors
Kopiere jeden Wert in das gleichnamige Feld in Claude und klicke Continue
Paddockhttps://paddock.finance/api/mcp/mcpAuthentication so lassen, wie Claude es erkannt hat, dann Add klicken
+ConnectorsPaddock
Nutze Paddock und sag mir, was du für mich tun kannst; zeig mir dann eine Sache✓ Wenn Claude sagt, dass es Paddock nutzt, oder ein Werkzeug von Paddock in der Antwort zeigt, bist du verbunden
Menünamen am 11. Nov. 2026 mit der Hilfe von Anthropic abgeglichen · dein Bildschirm kann je nach App-Version leicht abweichen
Klappt mit ChatGPT nur in Firmen-Tarifen
ChatGPT Business, Enterprise oder Edu im Web, hinzugefügt von Admin oder Inhaber des Workspace · Mit Free, Plus oder Pro: Dein ChatGPT-Tarif kann MCP noch nicht selbst verbinden
Plugins+Add custom MCP server
Namen eingeben, Adresse unter Connection einfügen, Risikohinweis abhaken und Create as a plugin klicken
Paddockhttps://paddock.finance/api/mcp/mcpNeuen Chat öffnen und vor dem Tippen Paddock aus deinen Plugins wählen
Nutze Paddock und sag mir, was du für mich tun kannst; zeig mir dann eine Sache✓ Wenn ChatGPT sagt, dass es Paddock nutzt, oder ein Werkzeug von Paddock in der Antwort zeigt, bist du verbunden
Menünamen am 11. Nov. 2026 mit der Hilfe von OpenAI abgeglichen · dein Bildschirm kann je nach App-Version leicht abweichen
Klappt mit Claude Code · etwa 2 Min.
Kein Schlüssel, nichts zu installieren
Mac: Command+Leertaste drücken und Terminal tippen · Windows: PowerShell öffnen
claude mcp add --transport http paddock https://paddock.finance/api/mcp/mcpPaddock sollte in der Liste als verbunden erscheinen
Nutze Paddock und sag mir, was du für mich tun kannst; zeig mir dann eine Sache✓ Wenn Claude Code sagt, dass es Paddock nutzt, oder ein Werkzeug von Paddock in der Antwort zeigt, bist du verbunden
Menünamen am 11. Nov. 2026 mit der Hilfe von Anthropic abgeglichen · dein Bildschirm kann je nach App-Version leicht abweichen
Klappt mit Cursor · etwa 2 Min.
Kein Schlüssel, nichts zu installieren
Nutze Paddock und sag mir, was du für mich tun kannst; zeig mir dann eine Sache✓ Wenn Cursor sagt, dass es Paddock nutzt, oder ein Werkzeug von Paddock in der Antwort zeigt, bist du verbunden
Menünamen am 11. Nov. 2026 mit der Hilfe von Cursor abgeglichen · dein Bildschirm kann je nach App-Version leicht abweichen
Klappt mit VS Code · etwa 2 Min.
Kein Schlüssel, nichts zu installieren
VS Code fragt nach einer Bestätigung; klicke Install
Nutze Paddock und sag mir, was du für mich tun kannst; zeig mir dann eine Sache✓ Wenn VS Code sagt, dass es Paddock nutzt, oder ein Werkzeug von Paddock in der Antwort zeigt, bist du verbunden
Menünamen am 11. Nov. 2026 mit der Hilfe von VS Code abgeglichen · dein Bildschirm kann je nach App-Version leicht abweichen
Andere Apps mit MCP, etwa Windsurf, Zed oder Gemini CLI, fügen Server unterschiedlich hinzu. Sieh in der App-Liste nach
Adresse für Apps, die über das Web verbinden
https://paddock.finance/api/mcp/mcpJSON-Einstellungen stehen unten unter „Für Entwickler“
Claude Code
claude mcp add --transport http paddock https://paddock.finance/api/mcp/mcpCursor (~/.cursor/mcp.json)
{
"mcpServers": {
"paddock": {
"url": "https://paddock.finance/api/mcp/mcp"
}
}
}VS Code (mcp.json)
{
"servers": {
"paddock": {
"type": "http",
"url": "https://paddock.finance/api/mcp/mcp"
}
}
}Diese Einstellungen werden aus dem Registry-Eintrag des Entwicklers erzeugt. Wenn in der README etwas anderes steht, folge der README.
Basierend darauf, wie sich dieser Server verbindet, und auf der eigenen Doku jeder App, geprüft am 10. Nov. 2026.
Verbinden sich über das Internet in
ClaudeChatGPTGooseLM StudioMsty StudioCherry StudioCursorVS Code + GitHub CopilotVisual StudioWindsurf (Devin Desktop)ZedKiroClineContinueJetBrains AI AssistantClaude CodeCodex CLIGemini CLIOpenCodenodecodeWarpLibreChatOpen WebUIRaycast
Tool-Namen und -Beschreibungen genau so, wie der Server sie am 8. Nov. 2026 gemeldet hat. Geschrieben hat sie der Entwickler, nicht wir; wir zeigen sie als reinen Text.
verify_before_payShould 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_payeeIs 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_summaryHow 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_livenessWas 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_signalIs 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_providerWhich 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_detailWho'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_gapsWhere 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_changesWhat 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_activityWhere 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_metricsIs 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_revenueWho 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_dataWhat 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
Wir prüfen Informationen, die jeder sehen kann; den Code haben wir nicht gelesen. Checks, die nicht zutreffen, werden nicht mitgezählt. · Geprüft am 11. Nov. 2026
Der Registry-Name wurde über die Domain paddock.finance bestätigt (die Registry prüft, wem die Domain gehört)
Code zuletzt geändert: vor 40 Tagen
Nutzt MIT
Antwort in 262 ms (HTTP 200)
Keine Anmeldung nötig
Wir haben 13 Tool-Beschreibungen gelesen und keine versteckten Anweisungen an die KI gefunden
Fragen, Tipps teilen oder melden, dass etwas nicht geht. Sortiert nach „hilfreich“.
Noch keine Beiträge. Stell die erste Frage oder teile einen Tipp.
Beiträge hier stammen von Nutzern, nicht vom PopNx-Team.
Noch keine Bewertungen
Verglichen mit allen aktiven Servern dieser Kategorie in der Registry. Sterne zählen nur, wenn dem Herausgeber das Repo gehört.
Er hat 5 von 5 zutreffenden Basischecks bestanden. Den Code haben wir nicht gelesen. Bevor du einen Schlüssel oder Token hinzufügst, sieh nach, welche Zugriffe der Server verlangt, und nutze einen Schlüssel, der nur die Berechtigungen hat, die du brauchst.
Die Registry nennt keinen erforderlichen Schlüssel, manche Server bitten dich aber bei der ersten Nutzung, dich anzumelden.
Er läuft in der Cloud des Entwicklers. Du verbindest dich übers Internet, ohne etwas zu installieren, aber was du sendest, läuft über die Server des Entwicklers.
Das GitHub-Repo wurde zuletzt vor 40 Tagen geändert, und die neueste Version (3.6.0) kam vor 40 Tagen in die Registry.
Apps, die MCP unterstützen, etwa Claude Desktop, Claude Code, Cursor und VS Code. Er verbindet sich per URL und funktioniert daher auch in Apps mit Remote-MCP, etwa ChatGPT Business und höher.
In derselben Kategorie: Spree Commerce developer docs for AI agents, Stripe MCP, Sessy — Amazon SES observability
Server derselben Kategorie von anderen Entwicklern, sortiert nach Sternen.
So liest du eine Karte:↓ Downloads pro Wochei★ GitHub-SterneiDrei Säulen: Bewertungen · Checks · NutzungiAktualisiert = neueste Version in der Registry veröffentlichti
Spree Commerce docs for AI coding agents: build headless B2B and marketplace ecommerce on its APIs.
MCP server integrating with Stripe - tools for customers, products, payments, and more.
Read-only Amazon SES observability: search events, inspect bounces, pull delivery stats.
Unverändert aus dem Repo des Entwicklers übernommen. PopNx MCP hat den Inhalt weder geprüft noch empfiehlt es ihn. HTML, Bilder und Skripte wurden entfernt. Links führen von dieser Website weg.
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.jsonin this repository is a byte-for-byte mirror of the live specification served atpaddock.finance/openapi.json, which is generated from the site's route and is the source of truth. Both declare the sameinfo.version(currently3.8.0); if they ever disagree, the live specification is correct and this file is stale. Use either for tool discovery and client generation.
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.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_datais published with two paths. The free-metadata route (/api/paddock/mcp/report-data) is declared withsecurity: []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 inopenapi.json.
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.
/.well-known/paddock-attestation-keyIn 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.
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).
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.
usage object (used, limit, remaining, resets_at) so you can meter yourself.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.
| 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.
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.
paddock.finance/docshello@paddock.financeProduction. Snapshots written daily at 23:30 UTC.