# x402 Market Intel MCP

Use this x402 MCP when an agent needs buyer intelligence before paying an x402 API, or when a seller needs to understand why an endpoint is not indexed, invocable, trusted, or paid.

Base URL: https://x402-market-intel-mcp.mtree.workers.dev
Payment rail: x402 on Base USDC
Discovery: https://x402-market-intel-mcp.mtree.workers.dev/.well-known/x402
OpenAPI: https://x402-market-intel-mcp.mtree.workers.dev/openapi.json
MCP: https://x402-market-intel-mcp.mtree.workers.dev/mcp

## What it answers

- Rank x402 services for a buyer intent before spend.
- Audit an endpoint for 402 behavior, payment metadata, schema/example quality, freshness, and use/avoid risk.
- Build a provider dossier by domain, payTo, or resource.
- Monitor paid API discovery, endpoint rankings, seller score, autopay readiness, and keyword visibility.

## Free previews

- https://x402-market-intel-mcp.mtree.workers.dev/preview/service_rank?preset=web_search&budget_usdc=0.25&limit=5&source=skill_md
- https://x402-market-intel-mcp.mtree.workers.dev/preview/endpoint_risk?url=https%3A%2F%2Fx402-market-intel-mcp.mtree.workers.dev%2Fv1%2Fx402%2Fservice_rank&source=skill_md
- https://x402-market-intel-mcp.mtree.workers.dev/preview/provider_dossier?provider=x402-market-intel-mcp.mtree.workers.dev&source=skill_md

## Paid routes

- POST /v1/x402/service_rank — 0.08 USDC — Ranks x402 services for a buyer intent before an agent spends: price, live marketplace demand, schema quality, payment behavior, seller evidence, freshness, and risk flags.
- POST /v1/x402/endpoint_risk — 0.05 USDC — Buyer-first pre-payment risk audit for a specific x402 endpoint/resource: pay/block recommendation, exact payment terms, live-vs-indexed payTo/amount/resource checks, replay/binding policy, freshness, and seller appendix.
- POST /v1/x402/provider_dossier — 0.08 USDC — Provider dossier for a seller payTo/domain/provider: service map, pricing distribution, registry coverage, buyer/call evidence, freshness, trust signals, and spend-policy guidance.
- POST /v1/x402/market_map — 0.08 USDC — Cross-source category and seller map for x402 paid services with revenue/call/payer concentration, registry coverage, and schema-quality gaps.
- POST /v1/x402/paid_api_discovery — 0.08 USDC — Paid search API and paid API discovery for agents searching verified x402 APIs: rank pay-per-call endpoints by buyer demand, price, registry coverage, schema/examples, seller score, endpoint rankings, and route reliability.
- POST /v1/x402/verified_endpoints — 0.08 USDC — Verified x402 API directory for autonomous agents: discover x402 pay-per-call endpoints with settlement proof, schema quality, examples, freshness, seller score, and registry coverage.
- POST /v1/x402/endpoint_rankings — 0.08 USDC — x402 endpoint rankings and seller score leaderboard for paid API discovery: compare resources by revenue proof, buyer breadth, price, metadata quality, and reliability signals.
- POST /v1/x402/search_rank_monitor — 0.20 USDC — Hosted x402 marketplace search-rank monitor for paid API discovery terms: records x402 Market Intel rank, top competing resources, rank deltas, freshness, and next proof action from recurring D1 marketplace snapshots.
- POST /v1/x402/buyer_intent_gap_report — 0.30 USDC — Hosted buyer-intent gap report for x402 paid API discovery: mines recurring marketplace snapshots and search-rank observations to rank urgent agent queries, under-indexed x402 Market Intel routes, competitor coverage, and next dataset/MCP route to ship.
- POST /v1/x402/autopay_readiness_matrix — 0.20 USDC — Hosted autopay readiness matrix for agents choosing paid x402 APIs: scores routes by payment envelope quality, schema/examples, buyer proof, price risk, seller breadth, freshness, and registry coverage before autonomous spend.
- POST /v1/x402/proof_lift_report — 0.20 USDC — Hosted proof-lift report for x402 paid API discovery campaigns: combines paid-call telemetry with recurring marketplace rank observations to show route proof coverage, index/rank movement, buyer-query lift, and the next bounded proof action.
- POST /v1/x402/keyword_visibility_pack — 0.15 USDC — Hosted keyword visibility pack for x402 paid API discovery: derives buyer search vocabulary, listing copy, schema/example gaps, route aliases, and proof terms from recurring CDP+PayAI resources, rank observations, and seller-score signals.
- POST /v1/x402/seller_score — 0.05 USDC — Score a payTo wallet, domain, or resource for observed revenue proof, buyer breadth, metadata quality, registry coverage, and route reliability.
- POST /v1/x402/emerging_categories — 0.10 USDC — Detect categories where buyer demand, revenue, or payer growth is high relative to supply and metadata completeness, highlighting underserved wedges.
- POST /v1/x402/resource_due_diligence — 0.15 USDC — Route-level trust/readiness report for an agent deciding whether to autopay an x402 resource, combining registry presence, schema/examples, seller proof, and peer category context.
- POST /v1/x402/category_gap_report — 0.10 USDC — Hosted proprietary category-gap report for builders: ranks x402 paid-service categories by observed demand, seller concentration, schema/example gaps, registry coverage, and freshness deltas from recurring D1 snapshots.
- POST /v1/x402/category_trends — 0.08 USDC — Time-series trend report from hosted D1 x402 observations: category demand deltas, new resources, seller concentration shifts, metadata-quality drift, and next build/proof recommendation.
- POST /v1/x402/top_earning_examples — 0.30 USDC — Aggregates x402 endpoints earning more than a revenue threshold and extracts copyable examples: pricing, schema/example completeness, registry coverage, request/response examples, metadata patterns, and why agents appear willing to pay. Refreshed from hosted CDP+PayAI discovery ingest.
- POST /v1/x402/listing_rank_doctor — 0.25 USDC — Seller-facing rank, listing, and payment-probe doctor across CDP, PayAI/Bazaar, AgentCash/x402scan, 402index, and x402gle/OpenDexter evidence where available. Returns verdict, surface matrix, exact metadata/schema/payment fixes, and the next measurable proof gate.
- POST /v1/x402/buyer_autopay_shortlist — 0.25 USDC — Buyer-agent shortlist for an x402 intent with spend cap, fallback route, avoid list, exact payment plan, and stop conditions before autonomous spend.
- POST /v1/x402/x402_endpoint_preflight — 0.20 USDC — Topdog-shaped endpoint risk preflight: one x402 URL in, pay/avoid/cap verdict out with live 402 probe, hosted graph evidence, examples, and exact autopay stop conditions.
- POST /v1/x402/tx_preflight_for_agents — 0.15 USDC — EVM transaction preflight modeled on top-earning tx simulator/explainer endpoints: decode target/value/data shape, probe bytecode, flag approvals/transfer selectors, and return sign/avoid/manual-review verdict.
- POST /v1/x402/token_contract_risk_scan — 0.25 USDC — Token/contract risk scan inspired by the top x402 earner: contract bytecode, ERC-20 metadata, high-risk function selectors, proxy/admin hints, and a pay/avoid/manual-review score for agent spend.
- POST /v1/x402/api_example_doctor — 0.08 USDC — Seller-facing schema/example doctor: compares an x402 resource to top-earning examples and returns exact missing request/response examples, listing copy, schema patches, and a measurable polish gate.
- POST /v1/x402/approval_spend_diff — 0.15 USDC — Approval-specific spend-risk preflight for agents: parse ERC-20 approve/permit/transfer calldata, identify spender and amount, check token/spender bytecode/current allowance, and return allow/deny/cap/revoke verdict before autonomous spend.
- POST /v1/x402/solana_risk_bridge — 0.15 USDC — Solana-heavy buyer-intel bridge: normalize Solana mint/signature/account checks into the same agent spend verdict format as EVM preflight, using live Solana RPC where possible and hosted top-earner demand patterns.
- POST /v1/x402/solana_token_preflight — 0.25 USDC — SPL token preflight for agents before trading, accepting, or routing to a Solana mint: live mint parsing, authority/freeze/supply checks, top-earner comps, verdict, risk score, and recommended spend/trade cap.
- POST /v1/x402/solana_tx_simulate_explain — 0.09 USDC — Base64 Solana transaction in, simulation/explanation verdict out: live simulateTransaction, logs, units consumed, account keys/instructions when parseable, sign/manual-review/avoid decision, and next action.
- POST /v1/x402/solana_program_risk_scan — 0.08 USDC — Program id in, trust verdict out for Solana agents: live executable/owner/lamports check, upgradeable-loader authority hints when available, known-program labels, usage comps, and sign/avoid policy.
- POST /v1/x402/paid_search_result_verifier — 0.08 USDC — Verifies whether a paid search/API result is worth paying for: query fit, freshness, schema/example quality, price fit, registry evidence, and pay/no-pay verdict.
- POST /v1/x402/micro_price_optimizer — 0.08 USDC — Category-sensitive price optimizer for x402 sellers: compares a route to live paid endpoints, topdog prices, calls, payers, and revenue to recommend a price band and A/B test.
- POST /v1/x402/agent_listing_conversion_score — 0.10 USDC — Scores an x402 endpoint listing against top-earning patterns and returns blockers, copy/OpenAPI patch payload, readback/measurement gate, and the next conversion action.
- POST /v1/x402/competitor_rank_watch — 0.15 USDC — Watches a category, query, domain, or payTo against live x402 graph competitors: rank deltas, winning copy/schema/pricing patterns, and one concrete move to copy for the next 48h.
- POST /v1/x402/proof_to_paid_playbook — 0.12 USDC — Turns listing/readback/preview proof into the smallest paid-call experiment: exact audience, source-tagged preview, paid JSON offer, stop conditions, and 48h measurement gate.

## Invocation notes

Send JSON to a paid route without a payment header to receive a 402 challenge. Pay using the returned x402 requirements, then retry the same JSON body with the x402 payment header. Include preview_id and source from a free preview when upgrading so preview-to-paid conversion can be measured.