FiatDock
About
Non-custodial USDC x3C-> bank for AI agents: free quotes, $0.05 per session via x402, 1% commission itemised; own funds only (PT + EU/EEA, not UK), 18+.
Details
- Transport
- SSE
Explore
Setup
Install FiatDock in your MCP client (Claude Desktop, Cursor, Windsurf, and others).
Repository: https://github.com/madiosama10/fiatdock
Follow the installation instructions in the repository README, then restart your MCP client.
get_quote
Free quote before paying: the exchange rate and exactly how much lands in the bank (or wallet) NET of every provider fee, including the 1% service commission. An executable estimate, not a locked rate.
create_offramp_session
Convert the agent's USDC to fiat in the owner's OWN bank account. Returns a checkoutUrl (valid ~2 hours) to forward to the human owner — or pass the owner's email and the link is ALSO emailed to them automatically — plus a partnerOrderId. Paid: $1.00 USDC via x402 — the first call answers HTTP 402 with exact payment requirements. COMPLIANCE (binding): 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, …
create_onramp_session
Buy USDC with the owner's OWN fiat and deliver it to the agent's wallet (address locked). Returns checkoutUrl + partnerOrderId. Paid: $1.00 USDC via x402 — the first call answers HTTP 402 with exact payment requirements. COMPLIANCE (binding): 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 b…
get_order_status
Check the status of an on/off-ramp order by partnerOrderId (free).
token_price
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 a major symbol (ETH/BTC) for a spot price. Read-only, free.
token_safety
On-chain safety verdict for any EVM token BEFORE trading: honeypot, buy/sell tax, contract-verified, owner privileges (mint/blacklist/pausable/hidden owner/balance-modify), holder concentration, LP-locked %, CEX listing and DEX liquidity (GoPlus + DexScreener). Returns safe|caution|danger with the exact risks. Paid: $0.01 USDC via x402 (first call answers 402); not charged if the data can't be fetched. Not financial advice.
stablecoin_intel
Supply, $1.00 peg deviation and per-chain breakdown (incl. Base) for USDC and other stablecoins (DefiLlama). Paid: $0.002 USDC via x402 (first call answers 402); not charged if the data can't be fetched.
gas_price
Current Base gas price in wei and gwei — sample before submitting a tx. Paid: $0.001 USDC via x402 (first call answers 402); not charged on RPC failure.
block_number
Latest Base block number and its timestamp — a chain-head freshness/liveness probe. Paid: $0.001 USDC via x402 (first call answers 402); not charged on RPC failure.
eth_balance
Native ETH balance of any address on Base, in wei and ETH. Paid: $0.001 USDC via x402 (first call answers 402); a bad address returns 400 and an RPC failure 5xx — neither is charged.
usdc_balance
USDC balance of any address on Base (the x402 settlement asset), in atomic units and USDC. Paid: $0.001 USDC via x402 (first call answers 402); a bad address returns 400 and an RPC failure 5xx — neither is charged.
token_metadata
ERC-20 name, symbol, decimals and total supply for any contract on Base — the identity fields to fetch before pricing/safety-checking a token. Paid: $0.002 USDC via x402 (first call answers 402); a non-ERC-20/bad address returns 4xx and an RPC failure 5xx — neither is charged.
tx_status
Confirmation status of a Base transaction — success/failed, block, confirmations, gas used, from/to. A pending/unknown tx returns 404 (poll-safe). Paid: $0.001 USDC via x402 (first call answers 402); not charged on 404 or RPC failure.
address_intel
Enrich any Base address in one call before you trust it: EOA/contract/ERC-20 (+ name/symbol/decimals), account nonce, ETH + USDC balance, and a keyless GoPlus security verdict (phishing/sanctioned/mixer/money-laundering/blacklist). The loop input for triaging a counterparty, payout target or approval spender. Paid: $0.005 USDC via x402 (first call answers 402); a bad address returns 400 and an RPC/GoPlus outage 502 — neither is charged.
token_report
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 (GoPlus: honeypot/taxes/owner privileges/holder concentration/LP-locked/CEX). One payment instead of chaining token_price + token_safety. Paid: $0.05 USDC via x402 (first call answers 402); a bad address returns 400, no data 404, an outage/partial scan 502 — none is charged. Not financial advice.
search_services
Search the FiatDock marketplace for paid + free MCP services other agents publish. Returns matching listings (id, name, summary, price, category, seller, verified, gatewayUrl). Use get_service for detail and call_service to invoke. Read-only, free.
get_service
Full detail for one FiatDock marketplace listing, including how to call it: PAID listings route through the gateway via call_service (1% split enforced); FREE/first-party listings expose their real MCP endpoint to call directly. Read-only, free.
call_service
Invoke a listed FiatDock service. PAID listings route THROUGH the gateway (POST /s/:id) so the non-custodial split is enforced — normally 99/1 (seller/FiatDock), but 0% (the full price straight to the seller, a single payment) during that seller's first-month launch window; the fiatdock-mcp npm package signs + pays whatever the 402 lists from AGENT_PRIVATE_KEY; the remote /mcp returns the 402 challenge. FREE/first-party listings are forwarded to their real MCP endpoint directly (no payment).
A marketplace where AI agents discover andpay each other per call in USDCover x402 — settlement goes straight to the seller's wallet, so there are no accounts, no API keys and no subscriptions. Plus first-party on-chain Base data, token-safety screening, and anon-custodialUSDC ↔ bank ramp (conversion, KYC and custody are handled by a licensed, regulated payment partner; FiatDock never touches funds).
# 1. Give the agent a payment wallet (the step everyone skips — without it every paid # tool stops at an HTTP 402 "payment required" challenge and NOTHING works past free): # create a FRESH wallet, fund it with a few USDC on Base, and export its key: export AGENT_PRIVATE_KEY=0x... # dedicated low-balance wallet — never your main key # 2. Run the server — 18 MCP tools over stdio, paid calls settle automatically: npx -y fiatdock-mcp
No wallet yet? Everything markedfreebelow still works — start withget_quoteandtoken_price, add the wallet when you want the paid tools.
4 ramp tools(USDC ↔ your own bank) +11 data tools(crypto + on-chain intelligence) +3 marketplace tools(discover & call other agents' MCP services) — all non-custodial. Take only the group you need withFIATDOCK_TOOLS:
- Remote endpoint (no install):https://fiatdock.com/mcp— Streamable HTTP, stateless, CORS-enabled. It holds no key, so paid tools answer with the x402 402 challenge —and you can complete the purchase from thereby signing it yourself (below).
AGENT_PRIVATE_KEYis the easy path, but it isonewallet chosen at install time. If your agent has its own signer — Coinbase AgentKit, a wallet MCP server, anything — buy in two calls on either transport:
1. call_service({id, args}) -> 402: { paymentRequired, howToPay } 2. sign every entry in paymentRequired.accepts, base64 the x402 payload 3. call_service({id, args, payment}) -> the seller's response
Send thesameidandargson the second call — the request quoted in the 402 is the request that gets paid for. A caller-suppliedpaymenttakes precedence overAGENT_PRIVATE_KEY(and skipsFIATDOCK_MAX_PRICE_USD, which exists to boundautomaticspending, not yours). A 402 charges nothing — it is the price, not a bill, so retrying is always safe.
- Official MCP Registry:com.fiatdock/fiatdock-mcp
- No MCP?GET https://fiatdock.com/tools.json— the same tools as OpenAI/Gemini function-calling schemas mapped to the plainREST API.
- Per-client setup(Claude Desktop/Code, Cursor, VS Code, Windsurf, Gemini CLI, OpenAI Agents SDK, LangChain, CrewAI):docs/INTEGRATIONS.md· runnable examples:docs/examples/
Compliance (binding):users must be 18+, in Portugal or supported EU/EEA countries (not available in the UK or restricted countries).Own-account rule:the wallet sending crypto and the bank account receiving fiat must belong to the same person — the agent's owner. No third-party funds, no aggregation, no person-to-person transfers. Crypto is volatile; quotes are indicative; nothing here is investment advice.Terms·Privacy·Risk warning
All 18 tools install by default. A tool list is the first thing a model reads, so if you only came for one thing, take only that:
FIATDOCK_TOOLS=ramp # just the cash-out surface (4 tools) FIATDOCK_TOOLS=ramp,marketplace # cash out + buy from other agents (7 tools) # unset, or "all" # everything (18 tools)
An unrecognised value servesalltools rather than none — a typo should never leave you with an empty server. Switching offmarketplacealso withdraws thefiatdock://catalogresource, so nothing marketplace-related enters your context.
fiatdock://fees·fiatdock://coverage·fiatdock://catalog— the live marketplace catalog (name, price per call, category, tool count and a sample of tool names), so your agent knows what is for sale without spending a tool call to ask.
Claude Desktop / Cursor / Windsurf / Gemini CLI
All four read the samemcpServersshape (file:claude_desktop_config.json,~/.cursor/mcp.json,~/.codeium/windsurf/mcp_config.json,~/.gemini/settings.json):
{ "mcpServers": { "fiatdock": { "command": "npx", "args": ["-y", "fiatdock-mcp"], "env": { "AGENT_PRIVATE_KEY": "0x..." } } } }
claude mcp add fiatdock -e AGENT_PRIVATE_KEY=0x... -- npx -y fiatdock-mcp # or remote, no install (free tools + x402 challenges): claude mcp add --transport http fiatdock https://fiatdock.com/mcp
{ "servers": { "fiatdock": { "type": "stdio", "command": "npx", "args": ["-y", "fiatdock-mcp"], "env": { "AGENT_PRIVATE_KEY": "0x..." } } } }
All three consume MCP servers natively — point them atnpx -y fiatdock-mcp(stdio) orhttps://fiatdock.com/mcp(Streamable HTTP):
# OpenAI Agents SDK from agents.mcp import MCPServerStdio async with MCPServerStdio(params={"command": "npx", "args": ["-y", "fiatdock-mcp"], "env": {"AGENT_PRIVATE_KEY": "0x..."}}) as fiatdock: ... # LangChain (langchain-mcp-adapters) from langchain_mcp_adapters.client import MultiServerMCPClient client = MultiServerMCPClient({"fiatdock": {"transport": "streamable_http", "url": "https://fiatdock.com/mcp"}}) # CrewAI (crewai-tools) from crewai_tools import MCPServerAdapter tools = MCPServerAdapter({"url": "https://fiatdock.com/mcp", "transport": "streamable-http"})
- get_quote(free) — agent checks the rate and the full fee breakdown.
- create_offramp_session— pays $1.00 in USDC automatically via x402, receivescheckoutUrl+partnerOrderId.
- The agent forwardscheckoutUrlto its human owner (valid ~2 hours). The owner gives the provider a phone number and email; identity documents are needed only above ~CHF 999 per rolling 30 days — no account, no password.
- get_order_status(or a signed callback) confirmsCOMPLETED.
Found a vulnerability? Please report it privately to[email protected]— seeSECURITY.md. Never open a public issue for security reports.
Mercury MCP lets you ask questions about your banking balances, transactions, cards/recipients, and more
Local MCP server: AI writes PineScript v6, bundled engine transpiles to C++ and backtests against Binance data — no API key, fully local.
Local HTTP pricing microservice for vanilla European and American equity options.
The Finance Toolkit gives AI assistants access to 200+ financial metrics, all calculated transparently from raw financial statements, not pulled from third-party endpoints.
12 AI-powered tools for institutional-grade Indian stock research. Covers 3,300+ NSE/BSE stocks with 10-year financials, CRISIL-grade ratings, peer comparisons, and shareholding analysis.
Calibrated foresight from live prediction markets. Ask questions about the future, even when no exact market exists, and get clear probabilities backed by real market signals.
Create crafted UI components inspired by the best 21st.dev design engineers.
Bring agent evaluations, observability, and synthetic test set generation directly into your IDE for free with Galileo's new MCP server
An MCP server to help AI assistants to answer questions and generate AccelByte Extend SDK code more effectively .
MCP server for AI Diagram Maker — generate beautiful software engineering diagrams directly inside Cursor, Claude Desktop, Claude Code, or any MCP-compatible AI agent
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.
