Home › Guides › MCP payments server

A payments MCP server: USDC ↔ bank

FiatDock ships a Model Context Protocol server that gives any MCP host — Claude Desktop/Code, Cursor, VS Code, Windsurf, Gemini CLI, OpenAI Agents SDK, LangChain, CrewAI — 47 tools: four ramp tools, eleven crypto-data tools (token price/safety/report, address intelligence, and Base gas/blocks/balances/tx-status/metadata), two web tools (a page reader and an email check), eleven market, web and document tools (Hyperliquid perps and funding, Polymarket odds, DeFi yields, FX rates, a Base wallet portfolio, token holders, domain intel, website contacts, crypto news, SEC filings and a prompt-injection check), six more research and analytics tools (a new-token screener, academic paper search, Sentinel-2 satellite images, a technical SEO audit, the x402 market leaderboard and an ENS resolver), eight everyday tools (time-zone conversion, public holidays, a weather forecast, Wikipedia summaries, Hacker News search, an RSS/Atom reader, an npm/PyPI package safety check and SEC company financials), plus five marketplace tools for discovering, inspecting and paying for other agents' MCP services — and for searching and paying any endpoint in the public x402 index. Listed in the official MCP Registry as com.fiatdock/fiatdock-mcp.

The ramp and marketplace tools (the eleven crypto-data tools and their prices are listed on pricing):

Local (auto-pays the x402 fee)

{
  "mcpServers": {
    "fiatdock": {
      "command": "npx",
      "args": ["-y", "fiatdock-mcp"],
      "env": { "AGENT_PRIVATE_KEY": "0x..." }
    }
  }
}

Same shape works in Claude Desktop, Cursor, Windsurf and Gemini CLI. AGENT_PRIVATE_KEY is optional — free tools work without it; use a dedicated low-balance wallet.

Remote (zero install)

https://fiatdock.com/mcp

Streamable HTTP, stateless, CORS-enabled, protocol versions 2024-11-05 through 2025-11-25. The remote endpoint holds no key, so paid tools return the x402 402 challenge as tool output — sign it with your own wallet and call call_service again with payment to complete the purchase there, or use the npm package for automatic signing. Try it:

curl -X POST https://fiatdock.com/mcp \
  -H "Content-Type: application/json" -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

No MCP host at all?

tools.json serves the same 47 tools as OpenAI/Gemini function-calling schemas mapped 1:1 to the REST API. Client-by-client setup: INTEGRATIONS.md · package: fiatdock-mcp on npm.

More guides: USDC to bank account API · How an AI agent cashes out crypto · x402 explained · All guides

Compliance (binding): own-account rule — the sending wallet and receiving bank account must belong to the same person (the agent's owner). 18+; served worldwide via our licensed provider across ~160 countries — EUR/SEPA in the EU/EEA (incl. Portugal), card elsewhere; not the UK, US persons or restricted jurisdictions (see Terms). Non-custodial: conversion, KYC and custody by a licensed, regulated payment partner.