# Paddock
> Paddock is the neutral, citable data layer for AI agent commerce — live on-chain data on what AI agents buy across the x402 and MPP payment protocols. Free dashboards and a free MCP server; a paid REST API and a monthly State of Agent Commerce report. This file indexes the documentation and data endpoints most useful to agents and LLMs.
## Documentation
- [API & MCP documentation (markdown)](https://paddock.finance/docs.md): Full integration guide — quickstart, authentication, every endpoint with parameters and examples, code samples, and rate limits.
- [Full documentation corpus](https://paddock.finance/llms-full.txt): The complete docs in a single file for long-context ingestion.
- [Agent skill](https://paddock.finance/skill.md): Operating guide for agents calling Paddock tools — when to use each tool, auth, and the x402 payment flow.
- [OpenAPI schema](https://paddock.finance/api/mcp/openapi.json): Machine-readable contract for every endpoint.
## MCP server
- [MCP endpoint](https://paddock.finance/api/mcp/mcp): Streamable HTTP MCP server. Exposes the free read-only tools `get_market_summary` and `get_category_detail` with no API key. Add as a custom connector in Claude (Settings → Connectors).
- [MCP discovery descriptor](https://paddock.finance/.well-known/mcp.json): Well-known descriptor pointing to the Paddock MCP server.
## Free tools (no key required)
- [get_market_summary](https://paddock.finance/api/mcp/summary): Current x402 transaction volume, top spending categories, live server count, and market overview.
- [get_category_detail](https://paddock.finance/api/mcp/category): All services in a category with transaction counts, pricing, and reliability scores. Parameter: `name`.
## Paid tools (Paddock API key in X-Paddock-Key, or an x402 micropayment)
- [get_niche_gaps](https://paddock.finance/api/mcp/gaps): Concentration and opportunity analysis across every category. $0.01 USDC/query.
- [get_best_value_provider](https://paddock.finance/api/mcp/best-value): Providers in a category ranked by a composite reliability/reputation/price score. Parameter: `category`. $0.02 USDC/query.
- [get_liveness](https://paddock.finance/api/mcp/liveness): Per-domain liveness against TrustBench probes. Parameter: `domain`. $0.001 USDC/query.
- [get_changes](https://paddock.finance/api/mcp/changes): Diff today's snapshot against an earlier date — new/retired services, category movements, top movers. Parameter: `since`. $0.10 USDC/query.
- [get_report_data](https://paddock.finance/api/mcp/report-data): Structured JSON from the monthly State of Agent Commerce report. Parameter: `month`. $0.99 USDC/query.
- [get_circular_signal](https://paddock.finance/api/mcp/circular-signal): Per-facilitator wash / circular-settlement signal — cluster volume, self-funding %, external-payer count, and trend (methodology v0.1). Parameter: `window`. $0.99 USDC/query.
- [get_whale_activity](https://paddock.finance/api/mcp/whale-activity): Large settlements and movers over a window, aggregate only — by facilitator, category, and size band. Parameters: `min_usd`, `window`. $0.99 USDC/query.
- [get_token_metrics](https://paddock.finance/api/mcp/token-metrics): First-party chart series plus the Agent Commerce Index (ACI), by metric and date range. Parameters: `metric`, `days`, `category`, `from`, `to`. $0.01 USDC/query.
## Data and dashboards
- [Market](https://paddock.finance/market): Live x402 market — what agents pay for, by category.
- [Charts](https://paddock.finance/charts): Time-series agent commerce charts.
- [Report](https://paddock.finance/report): The State of Agent Commerce monthly report.
- [Methodology](https://paddock.finance/methodology): How Paddock sources, snapshots, and scores the data.
## Access and pricing
- [Get API access](https://paddock.finance/api-access): Builder $99/mo (10,000 queries/day) and Pro Agent $499/mo (unlimited + archive).