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
- Author
- madiosama10
- Categories
- Finance, Developer Tools
Jump to
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.
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 toosama@fiatdock.com— 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.
