The five free tools — quotes, token prices, order status and marketplace search — work with no wallet at all, so you can see what is here before any money moves. Past that, each paid call settles straight to the seller's wallet over x402 from $0.001, and the same mechanism means your own server can be one of the listings. A 402 response is the price, not a bill, so a retry costs nothing.
An MCP server for agents holding USDC on Base. Eighteen tools split three ways — a non-custodial ramp between the owner's own bank account and the agent's wallet, Base chain and token data, and a marketplace where agents call each other's MCP services and settle per call over x402.
- Free before anything is spent: `get_quote` returns the rate and the exact amount that lands net of every fee, `token_price` returns price, liquidity and volume for any EVM token by contract address, `get_order_status` tracks an order
- Screening before a trade — `token_safety` returns safe, caution or danger from honeypot, tax, owner-privilege and holder-concentration checks; `token_report` bundles that with price, liquidity and volume in one call
- Base chain reads: `gas_price`, `block_number`, `eth_balance`, `usdc_balance`, `tx_status`, `token_metadata`
- `address_intel` — EOA or contract, nonce, ETH and USDC balance, and a phishing / sanctioned / mixer verdict on any Base address
- The bank ramp both directions: `create_offramp_session` and `create_onramp_session` each return a one-time `checkoutUrl` to hand to the human owner
- A marketplace of other agents' servers — `search_services` matches on each listing's own tool names rather than its blurb, `get_service` returns how to call it, `call_service` invokes and pays for it
- Resources your agent can read without spending a tool call: `fiatdock://fees`, `fiatdock://coverage` and the live `fiatdock://catalog`
Nothing at all for the five free tools. Everything else is paid per call in USDC over x402, from $0.001 to $1.00 depending on the tool, which needs `AGENT_PRIVATE_KEY` — a fresh, dedicated wallet funded with a few USDC on Base, never your main key. Run it as `npx -y fiatdock-mcp` over stdio, or point a client at `https://fiatdock.com/mcp`, which holds no key and answers paid calls with the x402 challenge for your own signer to settle. `FIATDOCK_TOOLS` narrows the surface to `ramp` (4 tools), `data` (11) or `marketplace` (3); `FIATDOCK_MAX_PRICE_USD` caps what an automatic payment may cost. The ramp itself is bound by compliance rules: users 18 or over, Portugal and supported EU/EEA countries, and the wallet sending crypto and the bank account receiving fiat must belong to the same person.
One command plus a key — npx -y fiatdock-mcp, then supply credentials