# FiatDock MCP server

Non-custodial USDC <-> bank for AI agents via x402 + Transak. Own funds only; PT + EU/EEA; 18+.

## Links
- Registry page: https://www.getdrio.com/mcp/com-fiatdock-fiatdock-mcp
- Repository: https://github.com/fiatdock/fiatdock
- Website: https://fiatdock.com

## Install
- Command: `npx -y fiatdock-mcp`
- Endpoint: https://fiatdock.com/mcp
- Auth: Not captured

## Setup notes
- Package: Npm fiatdock-mcp v1.4.0
- Environment variable: FIATDOCK_URL (default https://fiatdock.com)
- Environment variable: AGENT_PRIVATE_KEY (secret)
- Environment variable: FIATDOCK_MAX_PRICE_USD
- Remote endpoint: https://fiatdock.com/mcp

## Tools
- get_quote (Get a free quote) - Free quote before paying: the exchange rate and exactly how much lands in the bank (or wallet) NET of every provider fee — that net figure is the number to decide on. Executable estimate, not a locked rate. side=SELL (USDC->fiat) or BUY (fiat->USDC). Endpoint: https://fiatdock.com/mcp
- get_order_status (Get order status) - Check the status of an on/off-ramp order by partnerOrderId. Endpoint: https://fiatdock.com/mcp
- token_price (Token price & liquidity (free)) - FREE real-time price snapshot for any EVM token by contract address: USD price, 5m/1h/6h/24h change, liquidity, 24h volume, market cap/FDV and the most-liquid DEX pair (DexScreener). Or pass a major symbol (ETH/BTC) for a Coinbase spot price. Read-only, free. Endpoint: https://fiatdock.com/mcp
- search_services (Search the FiatDock marketplace) - Find paid + free MCP services other agents have published on the FiatDock marketplace. Returns matching listings (id, name, summary, price, category, seller, verified, gatewayUrl). Use get_service for full detail and call_service to invoke one. Read-only, free. Endpoint: https://fiatdock.com/mcp
- get_service (Get a marketplace service's detail) - Full detail for one FiatDock marketplace listing, including how to call it: PAID listings route through the gateway via call_service (the 99/1 split is enforced); FREE/first-party listings expose their real MCP endpoint to call directly. Read-only, free. Endpoint: https://fiatdock.com/mcp
- create_offramp_session (Create off-ramp session (USDC → bank)) - Convert the agent's USDC to fiat in the owner's OWN bank account. Returns a checkoutUrl to forward to the human owner (valid ~2 hours) and a partnerOrderId to track — pass the owner's `email` and the server ALSO emails the checkout link to them automatically (the response echoes emailedTo). Paid endpoint ($1.00 USDC via x402) — without payment this returns the 402 challenge; use the fiatdock-mcp npm package with AGENT_PRIVATE_KEY for automatic payment. COMPLIANCE: own-account rule — the sending wallet and the receiving bank account must belong to the SAME person (the agent's owner); no third-party funds, no aggregation, no P2P transfers. 18+; served worldwide via our licensed provider across ~160 countries — EUR bank transfer in the SEPA zone (incl. Portugal), card/Apple Pay/Google Pay elsewhere — excluding US persons, sanctioned countries and the UK (NOT the UK). Crypto is volatile; not investment advice. Endpoint: https://fiatdock.com/mcp
- create_onramp_session (Create on-ramp session (fiat → USDC)) - Buy USDC with the owner's OWN fiat and deliver it to the agent's wallet (address locked). Returns checkoutUrl + partnerOrderId. Paid endpoint ($1.00 USDC via x402) — without payment this returns the 402 challenge; use the fiatdock-mcp npm package with AGENT_PRIVATE_KEY for automatic payment. COMPLIANCE: own-account rule — the sending wallet and the receiving bank account must belong to the SAME person (the agent's owner); no third-party funds, no aggregation, no P2P transfers. 18+; served worldwide via our licensed provider across ~160 countries — EUR bank transfer in the SEPA zone (incl. Portugal), card/Apple Pay/Google Pay elsewhere — excluding US persons, sanctioned countries and the UK (NOT the UK). Crypto is volatile; not investment advice. Endpoint: https://fiatdock.com/mcp
- token_safety (Token safety & rug check ($0.01)) - PAID ($0.01 USDC via x402). On-chain safety verdict for any EVM token BEFORE you trade it: honeypot detection, buy/sell tax, contract-verified, owner privileges (mint / blacklist / pausable / hidden owner / balance-modify), holder concentration, LP-locked %, CEX listing and live DEX liquidity (GoPlus Security + DexScreener). Returns verdict safe|caution|danger with the exact risks. Without payment this returns the 402 challenge; the fiatdock-mcp npm package (AGENT_PRIVATE_KEY) pays automatically. Not financial advice. Endpoint: https://fiatdock.com/mcp
- stablecoin_intel (Stablecoin intelligence ($0.002)) - PAID ($0.002 USDC via x402). Supply, peg health and per-chain breakdown for USDC and other stablecoins: total circulating supply, deviation from the $1.00 peg, peg mechanism, the amount circulating on Base (with its share of total) and the top chains by supply (DefiLlama). A treasury/payments agent uses it to check its settlement asset is healthy. Without payment this returns the 402 challenge; the fiatdock-mcp npm package pays automatically. Endpoint: https://fiatdock.com/mcp
- gas_price (Base gas price ($0.001)) - PAID ($0.001 USDC via x402). The current Base gas price in wei and gwei. A gas-aware agent samples it before submitting a tx. Without payment this returns the 402 challenge; the fiatdock-mcp npm package pays automatically. On any RPC failure the call returns 4xx/5xx and is NOT charged. Endpoint: https://fiatdock.com/mcp
- block_number (Base block height ($0.001)) - PAID ($0.001 USDC via x402). The latest Base block number plus its timestamp — a freshness/liveness probe for agents that need to know the chain head. Without payment this returns the 402 challenge; the fiatdock-mcp npm package pays automatically. On any RPC failure the call returns 4xx/5xx and is NOT charged. Endpoint: https://fiatdock.com/mcp
- eth_balance (ETH balance on Base ($0.001)) - PAID ($0.001 USDC via x402). The native ETH balance of any address on Base, in wei and ETH. Without payment this returns the 402 challenge; the fiatdock-mcp npm package pays automatically. An invalid address returns 400 and is NOT charged; on any RPC failure it returns 5xx and is NOT charged. Endpoint: https://fiatdock.com/mcp
- usdc_balance (USDC balance on Base ($0.001)) - PAID ($0.001 USDC via x402). The USDC balance of any address on Base (the settlement asset for x402), in atomic units and USDC. Without payment this returns the 402 challenge; the fiatdock-mcp npm package pays automatically. An invalid address returns 400 and is NOT charged; on any RPC failure it returns 5xx and is NOT charged. Endpoint: https://fiatdock.com/mcp
- token_metadata (ERC-20 token metadata on Base ($0.002)) - PAID ($0.002 USDC via x402). Name, symbol, decimals and total supply for any ERC-20 contract on Base — the identity fields an agent needs before pricing or safety-checking a token. Without payment this returns the 402 challenge; the fiatdock-mcp npm package pays automatically. A non-ERC-20 / bad address returns 4xx and is NOT charged; on any RPC failure it returns 5xx and is NOT charged. Endpoint: https://fiatdock.com/mcp
- tx_status (Transaction status on Base ($0.001)) - PAID ($0.001 USDC via x402). Confirmation status of a Base transaction — success/failed, block, confirmations, gas used, from/to. An unconfirmed/unknown tx returns 404 (and is NOT charged), so an agent can poll safely. Without payment this returns the 402 challenge; the fiatdock-mcp npm package pays automatically. On any RPC failure it returns 5xx and is NOT charged. Endpoint: https://fiatdock.com/mcp
- address_intel (Address intelligence on Base ($0.005)) - PAID ($0.005 USDC via x402). Enrich ANY Base address in one call before you trust it: EOA vs contract (and whether it's an ERC-20, with its name/symbol/decimals), account nonce, ETH + USDC balance, and a KEYLESS GoPlus security verdict (phishing / sanctioned / mixer / money-laundering / blacklist and more) — the loop input for triaging a counterparty, payout target or approval spender. Without payment this returns the 402 challenge; the fiatdock-mcp npm package pays automatically. A bad address returns 400; if Base RPC or GoPlus is unavailable it returns 502 — neither is charged. Endpoint: https://fiatdock.com/mcp
- token_report (Token report — price + safety in one call ($0.05)) - PAID ($0.05 USDC via x402). The full picture on an ERC-20 in ONE call: live price, liquidity, 24h volume, market cap/FDV and the most-liquid DEX pair (DexScreener) TOGETHER with the complete safety verdict — honeypot / buy&sell tax / owner privileges / holder concentration / LP-locked / CEX listing (GoPlus). One payment instead of chaining token_price + token_safety. Without payment this returns the 402 challenge; the fiatdock-mcp npm package pays automatically. A bad address returns 400; no liquidity/security data returns 404; an upstream outage or partial scan returns 502 — none is charged. Not financial advice. Endpoint: https://fiatdock.com/mcp
- call_service (Call a marketplace service) - Invoke a listed FiatDock service. PAID listings go THROUGH the gateway (POST /s/:id) so the non-custodial split is enforced — normally TWO payments (99% seller + 1% FiatDock), or ONE full-price payment to the seller during that seller's first-month 0% launch window; this remote /mcp cannot sign payments, so it returns the gateway's 402 challenge as an error (use the fiatdock-mcp npm package with AGENT_PRIVATE_KEY to pay whatever the 402 lists automatically). FREE / first-party listings are forwarded to their real MCP endpoint directly (no payment). Pass the service's expected request body as `args`. Endpoint: https://fiatdock.com/mcp

## Resources
- fiatdock://fees - Fee schedule Current fee schedule: $1.00 x402 fee per paid call, 1% service commission included in conversion fees, what is free. Read before transacting. MIME type: application/json
- fiatdock://coverage - Coverage & eligibility Supported networks/currencies, service area, restricted jurisdictions and the binding own-account rule. Read before creating a session. MIME type: application/json

## Prompts
- cash-out-usdc - Cash out USDC to the owner's bank Step-by-step guided flow to convert the agent's USDC into fiat in the owner's own bank account: quote, compliance check, session, forwarding the checkout link, tracking the order. Arguments: amount, fiatCurrency

## Metadata
- Owner: com.fiatdock
- Version: 1.4.0
- Runtime: Npm
- Transports: STDIO, HTTP
- License: Not captured
- Language: Not captured
- Stars: Not captured
- Updated: Jul 26, 2026
- Source: https://registry.modelcontextprotocol.io