FiatDock

by fiatdock

Recommended
1 stars
1.1k downloads
Not rated
GitHub Website

About

A marketplace where AI agents discover and pay each other per call in USDC over x402 - settlement goes DIRECTLY to the seller's wallet, so there are no accounts, no API keys and no subscriptions. Buy from 24 live MCP ser

Details

Author
fiatdock
GitHub stars
1
Downloads
1,081
Categories
Finance

Setting up with Highlight

This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:

  1. Download and install Highlight from highlightai.com/download
  2. Navigate to the plugins tab and select "Add Custom Plugin"
  3. Configure the plugin with the settings below
    Plugin Name FiatDock
    Command (node, npx, python, etc.)

    Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.

  4. Enable "Start Automatically" if you want the plugin to start when Highlight launches

From the repository

{
  "mcpServers": {
    "fiatdock": {
      "command": "npx",
      "args": [
        "-y",
        "fiatdock-mcp"
      ],
      "env": {
        "AGENT_PRIVATE_KEY": "0x...",
        "FIATDOCK_TOOLS": "all"
      }
    }
  }
}

get_quote

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_order_status

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

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.

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.

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.

create_offramp_session

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) — this package pays it automatically from AGENT_PRIVATE_KEY, so the call succeeds without you seeing a 402. 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 + supported EU/EEA countries (NOT the UK). Crypto is volatile; not investment advice.

create_onramp_session

Buy USDC with the owner's OWN fiat and deliver it to the agent's wallet (address locked). Returns checkoutUrl (valid ~2 hours) + partnerOrderId. Paid endpoint ($0.01 USDC via x402) — this package pays it automatically from AGENT_PRIVATE_KEY, so the call succeeds without you seeing a 402. 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 + supported EU/EEA countries (NOT the UK). Crypto is volatile; not investment advice.

token_safety

PAID ($0.01 USDC via x402, paid automatically). 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. Not financial advice.

stablecoin_intel

PAID ($0.002 USDC via x402, paid automatically). 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.

gas_price

PAID ($0.001 USDC via x402, paid automatically). The current Base gas price in wei and gwei — a gas-aware agent samples it before submitting a tx. On any RPC failure the call returns 4xx/5xx and is NOT charged.

block_number

PAID ($0.001 USDC via x402, paid automatically). The latest Base block number plus its timestamp — a freshness/liveness probe for the chain head. On any RPC failure the call returns 4xx/5xx and is NOT charged.

eth_balance

PAID ($0.001 USDC via x402, paid automatically). The native ETH balance of any address on Base, in wei and ETH. An invalid address returns 400 (NOT charged); an RPC failure returns 5xx (NOT charged).

usdc_balance

PAID ($0.001 USDC via x402, paid automatically). The USDC balance of any address on Base (the x402 settlement asset), in atomic units and USDC. An invalid address returns 400 (NOT charged); an RPC failure returns 5xx (NOT charged).

token_metadata

PAID ($0.002 USDC via x402, paid automatically). 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. A non-ERC-20 / bad address returns 4xx (NOT charged); an RPC failure returns 5xx (NOT charged).

tx_status

PAID ($0.001 USDC via x402, paid automatically). Confirmation status of a Base transaction — success/failed, block, confirmations, gas used, from/to. An unconfirmed/unknown tx returns 404 (NOT charged) so an agent can poll safely; an RPC failure returns 5xx (NOT charged).

address_intel

PAID ($0.005 USDC via x402, paid automatically). Enrich ANY Base address in one call before you trust it: EOA vs contract (and whether it's an ERC-20, with 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. A bad address returns 400; if Base RPC or GoPlus is unavailable it returns 502 — neither is charged.

token_report

PAID ($0.05 USDC via x402, paid automatically). 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. 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.

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 legs (99% seller + 1% FiatDock), or ONE full-price leg to the seller during that seller's first-month 0% launch window; with AGENT_PRIVATE_KEY this signs and pays whatever the 402 lists automatically. WITHOUT a key — or to spend from a different wallet — buy in two calls: call once to get the 402 challenge and instructions, sign it yourself, then call again with the same id/args plus `payment` set to the base64 x402 payload (it is sent as the gateway's PAYMENT-SIGNATURE header — the x402 v2 name; the v1 X-PAYMENT is also accepted — and takes precedence over AGENT_PRIVATE_KEY). FREE / first-party listings are forwarded to their real MCP endpoint directly (no payment). Pass the service's expected request body as `args`.

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

{
    "mcpServers": {
        "fiatdock": {
            "fiatdock": {
                "command": "npx",
                "args": [
                    "-y",
                    "fiatdock-mcp"
                ],
                "env": {
                    "AGENT_PRIVATE_KEY": "0x...",
                    "FIATDOCK_TOOLS": "all"
                }
            }
        }
    }
}

McpServers

{
    "fiatdock": {
        "command": "npx",
        "args": [
            "-y",
            "fiatdock-mcp"
        ],
        "env": {
            "AGENT_PRIVATE_KEY": "0x...",
            "FIATDOCK_TOOLS": "all"
        }
    }
}

A marketplace where AI agents discover and pay each other per call in USDC over x402 - settlement goes DIRECTLY to the seller's wallet, so there are no accounts, no API keys and no subscriptions. Buy from 24 live MCP services, or list your own and get paid per call (1% commission, 0% for your first 30 days). Also ships 18 first-party tools: free token prices, on-chain Base data, token-safety and address-risk screening, and a non-custodial USDC<->bank ramp.

No reviews yet — be the first

Sign in to leave a review

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.