FiatDock — Claude Code MCP server: what it does, how to install
An MCP marketplace letting AI agents purchase tools per call with USDC via x402, plus direct bank off-ramping.
claude mcp add --transport http fiatdock-mcp https://fiatdock.com/mcpWhat FiatDock does
FiatDock functions as a service directory for autonomous software. Agents use it to query crypto prices, inspect websites, or invoke endpoints exposed by other agents. Payments settle directly between buyer and seller wallets via the x402 standard on Base without intermediaries holding funds. Charges trigger only after the remote party responds. If an upstream service drops the connection or errors out, no money leaves the wallet.
Basic operations such as price feeds and quotes run without a funded wallet. Using paid capabilities requires generating a dedicated address, funding it with Base USDC, and passing the AGENT_PRIVATE_KEY environment variable. Without this key, paid actions halt with an HTTP 402 error. You can restrict active endpoints using the FIATDOCK_TOOLS setting.
The server includes fiat off-ramping to an owner's bank account across 18 currencies handled by Mt Pelerin. Off-ramping requires reaching a threshold of roughly CHF 50 and involves mandatory KYC with an interactive browser step.
What it helps with
- pay external agents per tool invocation using Base USDC
- transfer agent cryptocurrency earnings directly to a bank account
- evaluate EVM token safety and honeypot risks
- query Polymarket betting odds and prediction data
Example prompts for the agent
- Check the Base gas price and get the USDC balance for 0x...
- Scan this token contract address for honeypots or tax risks
- Generate an off-ramp session to transfer agent USDC to my bank
How to install FiatDock
1Platform CLI: remote server
claude mcp add --transport http fiatdock-mcp https://fiatdock.com/mcp2Platform CLI
claude mcp add --env FIATDOCK_URL=<FIATDOCK_URL> --env FIATDOCK_TOOLS=<FIATDOCK_TOOLS> --env AGENT_PRIVATE_KEY=<AGENT_PRIVATE_KEY> --env FIATDOCK_MAX_PRICE_USD=<FIATDOCK_MAX_PRICE_USD> --transport stdio fiatdock -- npx -y fiatdock-mcpReplace <…> with your own values
1Platform CLI: remote server
codex mcp add fiatdock --url https://fiatdock.com/mcp2Platform CLI
codex mcp add fiatdock --env FIATDOCK_URL=<FIATDOCK_URL> --env FIATDOCK_TOOLS=<FIATDOCK_TOOLS> --env AGENT_PRIVATE_KEY=<AGENT_PRIVATE_KEY> --env FIATDOCK_MAX_PRICE_USD=<FIATDOCK_MAX_PRICE_USD> -- npx -y fiatdock-mcpReplace <…> with your own values
Config file
{
"mcpServers": {
"fiatdock": {
"url": "https://fiatdock.com/mcp"
}
}
}{
"mcpServers": {
"fiatdock": {
"command": "npx",
"args": [
"-y",
"fiatdock-mcp"
],
"env": {
"FIATDOCK_URL": "<FIATDOCK_URL>",
"FIATDOCK_TOOLS": "<FIATDOCK_TOOLS>",
"AGENT_PRIVATE_KEY": "<AGENT_PRIVATE_KEY>",
"FIATDOCK_MAX_PRICE_USD": "<FIATDOCK_MAX_PRICE_USD>"
}
}
}
}Replace <…> with your own values
Config file
{
"servers": {
"fiatdock": {
"type": "http",
"url": "https://fiatdock.com/mcp"
}
}
}{
"servers": {
"fiatdock": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"fiatdock-mcp"
],
"env": {
"FIATDOCK_URL": "<FIATDOCK_URL>",
"FIATDOCK_TOOLS": "<FIATDOCK_TOOLS>",
"AGENT_PRIVATE_KEY": "<AGENT_PRIVATE_KEY>",
"FIATDOCK_MAX_PRICE_USD": "<FIATDOCK_MAX_PRICE_USD>"
}
}
}
}Replace <…> with your own values
1Platform CLI: remote server
gemini mcp add -t http fiatdock https://fiatdock.com/mcp2Platform CLI
gemini mcp add -e FIATDOCK_URL=<FIATDOCK_URL> -e FIATDOCK_TOOLS=<FIATDOCK_TOOLS> -e AGENT_PRIVATE_KEY=<AGENT_PRIVATE_KEY> -e FIATDOCK_MAX_PRICE_USD=<FIATDOCK_MAX_PRICE_USD> fiatdock npx -y fiatdock-mcpReplace <…> with your own values
Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about FiatDock
How to install FiatDock in Claude Code?
Run claude mcp add --transport http fiatdock https://fiatdock.com/mcp to connect via HTTP.
What does FiatDock do?
It equips AI agents with a directory of paid tools and on-chain intelligence paid on demand in USDC, avoiding monthly subscription fees.
What is required to run paid FiatDock tools?
You need a dedicated Base wallet funded with USDC and its private key stored in AGENT_PRIVATE_KEY. Paid requests will halt on HTTP 402 if the key is missing.
