com.fiatdock/fiatdock-mcp

Official10 tools

by fiatdock · JavaScript

FiatDock

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

Non-custodial USDC-to-bank conversion for AI agents in PT and EU/EEA regions.

Topics

ai-agentsmcpofframpusdcx402agent-paymentsmcp-servermodel-context-protocolonramppaymentsstablecoin

Captured live from the server via tools/list.

create_offramp_session

Convert the agent's USDC to fiat in the owner's OWN bank account. Returns a one-time checkoutUrl (forward it to the human owner; valid 5 minutes, single use) and a partnerOrderId to track. Paid endpoint ($0.05 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+; service area: Portugal + Transak-supported EU/EEA countries (NOT the UK). Crypto is volatile; not investment advice.

Parameters (6)

cryptoAmountnumberrequired
USDC amount to sell
fiatCurrencystring
e.g. EUR, default EUR
networkstring
USDC network, default base
emailstring
Owner's Transak account email
customerIdstring
Stable agent/customer id
refstring
Optional referral code (1-64 chars: letters, digits, _ or -)

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 endpoint ($0.05 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+; service area: Portugal + Transak-supported EU/EEA countries (NOT the UK). Crypto is volatile; not investment advice.

Parameters (7)

fiatAmountnumberrequired
Fiat amount to spend
walletAddressstringrequired
Agent wallet that receives USDC
fiatCurrencystring
e.g. EUR, default EUR
networkstring
USDC network, default base
emailstring
Owner's Transak account email
customerIdstring
Stable agent/customer id
refstring
Optional referral code (1-64 chars: letters, digits, _ or -)

get_quote

Free quote before paying: exchange rate, total fees (all itemised, incl. the 1% service commission), and amount received. Quotes are indicative, not guaranteed. side=SELL (USDC->fiat) or BUY (fiat->USDC).

Parameters (5)

sidestring
SELL = USDC to fiat, BUY = fiat to USDC
cryptoAmountnumber
USDC amount (required for SELL)
fiatAmountnumber
Fiat amount (for BUY)
fiatCurrencystring
e.g. EUR, default EUR
networkstring
USDC network, default base

get_order_status

Check the status of an on/off-ramp order by partnerOrderId.

Parameters (1)

partnerOrderIdstringrequired
Order id returned when the session was created

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 pass a major symbol (ETH/BTC) for a Coinbase spot price. Read-only, free.

Parameters (3)

tokenstring
ERC-20 contract address (0x…) — preferred
chainstring
Chain slug: base (default), ethereum, polygon, arbitrum, optimism, bsc, avalanche
symbolstring
Major asset symbol (e.g. ETH, BTC) — used when no contract address is given

token_safety

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.

Parameters (2)

tokenstringrequired
ERC-20 contract address (0x…) to screen
chainstring
Chain slug: base (default), ethereum, polygon, arbitrum, optimism, bsc, avalanche

stablecoin_intel

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.

Parameters (1)

assetstring
Stablecoin symbol (default USDC), e.g. USDC, USDT, DAI, USDe

search_services

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.

Parameters (4)

qstring
Free-text search over name, summary, description and tags
categorystring
Filter by category slug: data, search, finance, dev, productivity, ai, web, other
verifiedOnlyboolean
Only verified listings (KYC'd seller or first-party)
sortstring
Sort order (default newest; first-party listings are always featured first)

get_service

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.

Parameters (1)

idstringrequired
Listing id (svc_…) from search_services

call_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`.

Parameters (2)

idstringrequired
Listing id (svc_…) to invoke, from search_services
argsobject
JSON payload to send to the service (e.g. an MCP JSON-RPC request body) — shape is defined by that service

Install

Configuration

Environment variables

FIATDOCK_URLdefault https://fiatdock.com

FiatDock API base URL

AGENT_PRIVATE_KEYsecret

Agent wallet key that auto-pays the $0.05 USDC x402 fee for paid tools. Optional: free tools (get_quote, get_order_status) work without it. Use a dedicated low-balance wallet.

claude_desktop_config.json

{
  "mcpServers": {
    "fiatdock-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "fiatdock-mcp@1.2.0"
      ],
      "env": {
        "FIATDOCK_URL": "https://fiatdock.com",
        "AGENT_PRIVATE_KEY": "<YOUR_AGENT_PRIVATE_KEY>"
      }
    }
  }
}