mcp server

FiatDock

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

Description as published by the maintainer. Source

• version 1.4.0
• active

active — Most recent push to the repository was 2026-06-17.

What this server can do

18 functions, named and described by the server itself. Parameter names are shown because they say more about what a function does than its name usually does.

address_intel(address)

PAID ($0.005 USDC via x402). Enrich ANY Base address in one call before you trust it: EOA vs contract (and whether it's an ERC-20, with its name/symbol/decimals), account nonce, ETH + USDC balance, and a KEYLESS GoPlus security verdict (phishing / sanctioned / mixer / money-laundering / blacklist and more) — the loop input for triaging a counterparty, payout target or approval spender. Without payment this returns the 402 challenge; the fiatdock-mcp npm package pays automatically. A bad address returns 400; if Base RPC or GoPlus is unavailable it returns 502 — neither is charged. Required: address.

block_number

PAID ($0.001 USDC via x402). The latest Base block number plus its timestamp — a freshness/liveness probe for agents that need to know the chain head. Without payment this returns the 402 challenge; the fiatdock-mcp npm package pays automatically. On any RPC failure the call returns 4xx/5xx and is NOT charged.

call_service(id, args, payment)

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. TO BUY: call once WITHOUT `payment` to get the 402 challenge and step-by-step instructions, sign it with your own wallet, then call again with the same id/args plus `payment` set to the base64 x402 payload — the gateway settles on-chain directly to the seller and returns their response. No wallet? `npx fiatdock-mcp` with AGENT_PRIVATE_KEY signs automatically. FREE / first-party listings are forwarded to their real MCP endpoint directly (no payment). Pass the service's expected request body as `args`. Required: id.

create_offramp_session(ref, email, network, provider, customerId, walletCode, walletHash, callbackUrl, cryptoAmount, fiatCurrency, walletAddress)

Convert the agent's USDC to fiat in the owner's OWN bank account. Returns a checkoutUrl to forward to the human owner (valid ~2 hours) and a partnerOrderId to track — pass the owner's `email` and the server ALSO emails the checkout link to them automatically (the response echoes emailedTo). Paid endpoint ($0.01 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+; served worldwide via our licensed provider across ~160 countries — EUR bank transfer in the SEPA zone (incl. Portugal), card/Apple Pay/Google Pay elsewhere — excluding US persons, sanctioned countries and the UK (NOT the UK). Crypto is volatile; not investment advice. Required: cryptoAmount.

create_onramp_session(ref, email, network, provider, customerId, fiatAmount, walletCode, walletHash, callbackUrl, fiatCurrency, walletAddress)

Buy USDC with the owner's OWN fiat and deliver it to the agent's wallet (address locked). Returns checkoutUrl + partnerOrderId. Paid endpoint ($0.01 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+; served worldwide via our licensed provider across ~160 countries — EUR bank transfer in the SEPA zone (incl. Portugal), card/Apple Pay/Google Pay elsewhere — excluding US persons, sanctioned countries and the UK (NOT the UK). Crypto is volatile; not investment advice. Required: fiatAmount, walletAddress.

eth_balance(address)

PAID ($0.001 USDC via x402). The native ETH balance of any address on Base, in wei and ETH. Without payment this returns the 402 challenge; the fiatdock-mcp npm package pays automatically. An invalid address returns 400 and is NOT charged; on any RPC failure it returns 5xx and is NOT charged. Required: address.

gas_price

PAID ($0.001 USDC via x402). The current Base gas price in wei and gwei. A gas-aware agent samples it before submitting a tx. Without payment this returns the 402 challenge; the fiatdock-mcp npm package pays automatically. On any RPC failure the call returns 4xx/5xx and is NOT charged.

get_order_status(partnerOrderId)

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

get_quote(side, network, fiatAmount, cryptoAmount, fiatCurrency)

Free quote before paying: the exchange rate and exactly how much lands in the bank (or wallet) NET of every provider fee — that net figure is the number to decide on. Executable estimate, not a locked rate. side=SELL (USDC->fiat) or BUY (fiat->USDC).

get_service(id)

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. Required: id.

search_services(q, sort, category, verifiedOnly)

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.

stablecoin_intel(asset)

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.

token_metadata(token)

PAID ($0.002 USDC via x402). Name, symbol, decimals and total supply for any ERC-20 contract on Base — the identity fields an agent needs before pricing or safety-checking a token. Without payment this returns the 402 challenge; the fiatdock-mcp npm package pays automatically. A non-ERC-20 / bad address returns 4xx and is NOT charged; on any RPC failure it returns 5xx and is NOT charged. Required: token.

token_price(chain, token, symbol)

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.

token_report(chain, token)

PAID ($0.05 USDC via x402). 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 — honeypot / buy&sell tax / owner privileges / holder concentration / LP-locked / CEX listing (GoPlus). One payment instead of chaining token_price + token_safety. Without payment this returns the 402 challenge; the fiatdock-mcp npm package pays automatically. A bad address returns 400; no liquidity/security data returns 404; an upstream outage or partial scan returns 502 — none is charged. Not financial advice. Required: token.

token_safety(chain, token)

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. Required: token.

tx_status(txHash)

PAID ($0.001 USDC via x402). Confirmation status of a Base transaction — success/failed, block, confirmations, gas used, from/to. An unconfirmed/unknown tx returns 404 (and is NOT charged), so an agent can poll safely. Without payment this returns the 402 challenge; the fiatdock-mcp npm package pays automatically. On any RPC failure it returns 5xx and is NOT charged. Required: txHash.

usdc_balance(address)

PAID ($0.001 USDC via x402). The USDC balance of any address on Base (the settlement asset for x402), in atomic units and USDC. Without payment this returns the 402 challenge; the fiatdock-mcp npm package pays automatically. An invalid address returns 400 and is NOT charged; on any RPC failure it returns 5xx and is NOT charged. Required: address.

Last successful function declaration observed on 2026-08-13. Source: https://fiatdock.com/mcp. We list what the server declared; we do not call any of these functions.

Endpoint status observed on 2026-08-13. Source: https://fiatdock.com/mcp.

Signals

These are separate measurements of different things. They are deliberately not combined into one score, because a popularity number that mixes website traffic with saves and stars cannot be checked or acted on.

Where to get it

• Repository — https://github.com/fiatdock/fiatdock
• Website — https://fiatdock.com
• npm: fiatdock-mcp
• Remote endpoint (streamable-http) — https://fiatdock.com/mcp

Related, by what their authors tagged them

• io.github.cammac-creator/ibanforge — last commit 2026-08-06, shares sepa, x402
  Pre-payout IBAN screening for AI agents: validation, sanctions, Swiss clearing, risk scoring
• DePix App MCP — last commit 2026-08-06, shares non-custodial, payments
  One MCP: hosted Pix receive + dated charges (22 tools), or local npx non-custodial wallet (49).
• ai.traderouter/trade-router-mcp — last commit 2026-04-28, shares non-custodial
  Non-custodial Solana swap & limit order engine for AI agents.
• io.github.Eronmmer/bloomfilter — last commit 2026-02-26, shares base, stablecoin, usdc
  Service that lets AI Agents search, register, and configure domains
• io.github.Dempty-glitch/z-zero-mcp — last commit 2026-08-06, shares base, stablecoin, usdc
  Payments for AI agents: gasless USDC on Base + JIT single-use virtual cards, PAN never in context.
• io.github.ElToro1855/ozav-mcp-server — last commit 2026-04-05, shares stablecoin, usdc
  Forex, IOF tax, US accounts, stablecoins, and international payments in Brazil.
• io.github.FurlPay/furlpay-cli — last commit 2026-07-08, shares payments, stablecoin
  Stablecoin payments, swaps, stock orders, market data, travel booking, yield and card controls.
• dev.forgesworn/402-mcp — last commit 2026-07-29, shares stablecoin, x402
  AI agents discover, pay for, and consume any Lightning-gated API autonomously
• FeedOracle Compliance Agent — last commit 2026-04-12, shares stablecoin
  MiCA compliance evidence, stablecoin risk, macro regime, agent governance. 79 tools.
• FeedOracle Stablecoin Risk — last commit 2026-03-19, shares stablecoin
  7-signal stablecoin risk scoring. 13 tools, 28+ tokens, SAFE/CAUTION/AVOID verdicts.

These share tags the maintainers applied themselves, such as sepa, x402, non-custodial, payments. Common tags like "mcp" or "ai" are ignored for this: agreeing with six hundred other projects is not a similarity.

This is not a recommendation and not a test result. It is a map of what the authors said their work is about.

How the author describes it

Topics the maintainer set on GitHub: agent-payments, ai-agents, base, mcp, mcp-marketplace, mcp-server, model-context-protocol, non-custodial, offramp, onramp, payments, sepa, stablecoin, usdc, x402.