# Satoshi API x402 Facilitator Lab

> Stable x402 proof origin for discovering and testing paid HTTP endpoints and payable MCP tools.

Last updated: 2026-04-28T15:02:52.830Z
Canonical URL: https://x402.bitcoinsapi.com/x402-facilitator
HTTP origin: https://x402.bitcoinsapi.com
MCP origin: https://mcp.bitcoinsapi.com
Network: eip155:84532
Pay-to address: 0x2eDbF699657ae1A09D9C3833FD162A6b59344364
Facilitator: https://api.cdp.coinbase.com/platform/v2/x402

## What This Is

This origin exposes machine-readable x402 discovery documents, a no-wallet 402 challenge path, paid HTTP routes, and a public MCP status surface. It is meant to help agents, directories, crawlers, and x402 client authors inspect route metadata before spending.

## Discovery Documents

- OpenAPI: https://x402.bitcoinsapi.com/openapi.json
- Well-known x402: https://x402.bitcoinsapi.com/.well-known/x402
- Agent manifest: https://x402.bitcoinsapi.com/.well-known/agent.json
- Catalog JSON: https://x402.bitcoinsapi.com/x402-facilitator/catalog.json
- Tester kit: https://x402.bitcoinsapi.com/x402-facilitator/tester.json
- Sitemap: https://x402.bitcoinsapi.com/sitemap.xml
- Robots: https://x402.bitcoinsapi.com/robots.txt

## Paid HTTP Resources

- GET /merchant-payout-plan: Bitcoin merchant payout plan. Price $0.003 USD. Returns a batch payout fee-band and timing plan for a merchant payout run. URL: https://x402.bitcoinsapi.com/merchant-payout-plan
- GET /weather: Minimal paid HTTP proof. Price $0.001 USD. Small paid JSON route used to verify the complete 402 challenge, payment, settle, and receipt flow. URL: https://x402.bitcoinsapi.com/weather

## Free Discovery Resources

- GET /x402-facilitator/catalog.json: Public endpoint catalog. Machine-readable surface with endpoint metadata, conventional launch channels, and proof targets.
- GET /x402-facilitator/tester.json: External tester kit. Single JSON handoff with the no-wallet 402 check, cheapest paid HTTP route, merchant paid route, and MCP health check.

## MCP Tools

MCP status: https://mcp.bitcoinsapi.com/status
- get_current_fee_snapshot: free. Entry point for agents that need a no-payment first call.
- plan_merchant_payout_batch: paid once, then SIWX reuse for the same tool scope. Proves paid MCP monetization without making every reconnect repay.
- plan_expedited_payout_batch: separate paid scope. Proves route/tool-specific access instead of account-global unlocks.

## Verification Commands

- Discover paid HTTP routes: npx agentcash@latest discover https://x402.bitcoinsapi.com --format json Expected: success: true with paid /weather and /merchant-payout-plan endpoints
- No-wallet 402 challenge: curl -i "https://x402.bitcoinsapi.com/weather" Expected: HTTP 402 with a PAYMENT-REQUIRED header
- Lowest-friction paid HTTP call: npx agentcash@latest fetch "https://x402.bitcoinsapi.com/weather" Expected: HTTP 200 paid JSON response after a $0.001 Base Sepolia x402 payment
- Merchant paid HTTP call: npx agentcash@latest fetch "https://x402.bitcoinsapi.com/merchant-payout-plan?batchSize=24&targetBlocks=3&urgency=balanced" Expected: HTTP 200 merchant payout plan after a $0.003 Base Sepolia x402 payment
- MCP health check: curl https://mcp.bitcoinsapi.com/status Expected: ok: true with plan_merchant_payout_batch and plan_expedited_payout_batch tools

## Known Good Receipts

- HTTP merchant payout settlement: 0x30ff7b33ec19dff3d77373794584b40315ce497942bfe6f2b064a28e7d56e7d5
- MCP merchant payout settlement: 0x27f2db0c850823bf1e6c4f35a589106e00f39cc96a5ecf68e9a164184c3d79f1

## Caveats

- The production mainnet Satoshi API surface is https://bitcoinsapi.com/x402.
- This proof origin is a Base Sepolia lab surface for discovery and external testing.
- CDP search and merchant discovery can show the proof origin before CDP resources query visibility catches up.