# FiatDock

An MCP marketplace letting AI agents purchase tools per call with USDC via x402, plus direct bank off-ramping.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 1
- Author: fiatdock
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/fiatdock/fiatdock
- Updated: 2026-10-16
- HTML: https://affpapa.org/en/nevibecode/mcp/fiatdock

## What it 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.

## Requirements
- Needs: Node.js (commands run via npx)
- Remote server: `https://fiatdock.com/mcp`
- Environment variables: `FIATDOCK_URL`, `FIATDOCK_TOOLS`, `AGENT_PRIVATE_KEY`, `FIATDOCK_MAX_PRICE_USD` — keys and tokens: ask the human for the values, never commit them or put them in shared files.

## Install

### Claude Code (native platform)

1. **Platform CLI: remote server**
```bash
claude mcp add --transport http fiatdock-mcp https://fiatdock.com/mcp
```

2. **Platform CLI**
```bash
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-mcp
```
Replace <…> with your own values

### Codex

1. **Platform CLI: remote server**
```bash
codex mcp add fiatdock --url https://fiatdock.com/mcp
```

2. **Platform CLI**
```bash
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-mcp
```
Replace <…> with your own values

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "fiatdock": {
            "url": "https://fiatdock.com/mcp"
        }
    }
}
```
File `.cursor/mcp.json`:
```json
{
    "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

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "fiatdock": {
            "type": "http",
            "url": "https://fiatdock.com/mcp"
        }
    }
}
```
File `.vscode/mcp.json`:
```json
{
    "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

### Gemini CLI

1. **Platform CLI: remote server**
```bash
gemini mcp add -t http fiatdock https://fiatdock.com/mcp
```

2. **Platform CLI**
```bash
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-mcp
```
Replace <…> with your own values

## When to use it
- 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
- 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

## Similar
- [World Monitor](https://affpapa.org/en/nevibecode/mcp/world-monitor.md) — MCP server · ★ 89609
- [CCXT](https://affpapa.org/en/nevibecode/mcp/ccxt.md) — MCP server · ★ 44591
- [Finance Toolkit](https://affpapa.org/en/nevibecode/mcp/finance-toolkit.md) — MCP server · ★ 5469
- [EdgarTools](https://affpapa.org/en/nevibecode/mcp/edgartools.md) — MCP server · ★ 2817
- [LetsFG — Flights & Hotels](https://affpapa.org/en/nevibecode/mcp/letsfg-flights-hotels.md) — MCP server · ★ 2197
- [AutoTS](https://affpapa.org/en/nevibecode/mcp/autots.md) — MCP server · ★ 1434

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md