Skip to content
verify mcp Beta VerifyMCP is currently in beta. If you notice any issues, email [email protected] and we’ll put it right.

FiatDock

REMOTE · FIATDOCK.COM · 2 COMPONENTS · SCANNED AUG 3

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

+5 this week 71 Trust /100
Trust breakdown (6 categories)

How this component scores in each security and reliability category. Every signal is checked automatically against the live server, and we only credit what we can confirm. How we score →

Endpoint Security66
  • The endpoint's TLS certificate is valid, in date, and uses a strong key. View diagnostics → Pass
  • Authorisation not fully verified: no authorisation is required to call this server, and 15 tool(s) never declared a destructiveHint. The MCP spec treats an absent hint as destructive by default, so we cannot call this surface safe. See how to fix → View diagnostics → Unverified
  • HTTPS is enforced; there's no plaintext access path. View diagnostics → Pass
  • The HSTS (Strict-Transport-Security) header is present. View diagnostics → Pass
  • DNSSEC is configured correctly; the domain's records validate against the full chain to the root. View diagnostics → Pass
Transport & Reachability100
Schema Quality & AI Usability79
  • 100% of prompts and resources have a non-trivial description (not blank, and not just the item's name).Pass
  • AI-judged instruction clarity (excellent).Pass
  • Context-footprint check failed: tool/resource definitions use about 3240 tokens (~162/item across 20 items; 18 tools + 2 resources), over budget; trim descriptions and params. See how to fix → Fail
  • Usage-examples check failed: none of the tools include examples. See how to fix → Fail
Stability & Change Management27
  • Stability observed for 8 of 30 days with no destabilising changes; credit accrues until the full window elapses.Partial
Tool Coverage100
  • 100% of tools have a non-trivial description (not blank, and not just the tool's name).Pass
  • 100% of tool parameters carry a description.Pass
  • Structured output schemas are declared (100% of tools); any adoption earns full credit.Pass
Capabilities100
  • Implements a supported MCP spec version (2025-11-25); the latest is 2026-07-28.Pass
Install

Add this component to your MCP client. Where a client-specific snippet is available, pick your client below and copy it straight into your config; otherwise use the connection detail shown.

remote · fiatdock.com

# add to Claude Code
claude mcp add --transport http com-fiatdock-fiatdock-mcp https://fiatdock.com/mcp
# ~/.codex/config.toml
[mcp_servers.com-fiatdock-fiatdock-mcp]
url = "https://fiatdock.com/mcp"
// opencode.json
{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "com-fiatdock-fiatdock-mcp": {
      "type": "remote",
      "url": "https://fiatdock.com/mcp",
      "enabled": true
    }
  }
}
# add to OpenClaw
openclaw mcp add com-fiatdock-fiatdock-mcp --url https://fiatdock.com/mcp --transport streamable-http
# ~/.hermes/config.yaml
mcp_servers:
  com-fiatdock-fiatdock-mcp:
    url: "https://fiatdock.com/mcp"
// mcp.json
{
  "mcpServers": {
    "com-fiatdock-fiatdock-mcp": {
      "type": "http",
      "url": "https://fiatdock.com/mcp"
    }
  }
}

The mcpServers block is a cross-client convention. Remote transports vary, so check your client's docs.

Changelog

Every change we have recorded for this component, newest first. Security-relevant changes are always shown. ▲ marks a change for the better, ▼ a change for the worse; unmarked changes are neutral.

  • 2 Aug 26 +1

    No change was recorded against any check on this day. Stability & Change Management went from 20 to 23. That category is still filling its 30-day observation window: 6 days of observed history at the previous scan, 7 at this one. The score rises as the window fills, whether or not the server changes.

  • 31 Jul 26 +1
    • We updated how we score, so this day's move reflects our rubric, not a change to the server See what changed → functional
  • 30 Jul 26 +1
    • We updated how we score, so this day's move reflects our rubric, not a change to the server See what changed → functional
  • 29 Jul 26 +1
    • Tool “create_offramp_session” rewrote its description, which is the text the model reads security
    • Tool “create_onramp_session” rewrote its description, which is the text the model reads security
    • Tool “get_quote” rewrote its description, which is the text the model reads security
    • Schema quality: 152 → 174 functional
    • Server version: 1.4.0 → 1.5.1 functional
    • “create_onramp_session” added an optional parameter “walletHash” cosmetic
    • “create_offramp_session” added an optional parameter “callbackUrl” cosmetic
    • “create_offramp_session” added an optional parameter “walletAddress” cosmetic
    • “create_offramp_session” added an optional parameter “walletCode” cosmetic
    • “create_offramp_session” added an optional parameter “walletHash” cosmetic
    • “create_onramp_session” added an optional parameter “callbackUrl” cosmetic
    • “create_onramp_session” added an optional parameter “walletCode” cosmetic
    • “create_offramp_session” reworded the description of “email” cosmetic
    • “create_offramp_session” reworded the description of “provider” cosmetic
    • “create_onramp_session” reworded the description of “email” cosmetic
    • “create_onramp_session” reworded the description of “provider” cosmetic
    • “create_onramp_session” reworded the description of “walletAddress” cosmetic
  • 28 Jul 26 +1

    No change was recorded against any check on this day. Stability & Change Management went from 3 to 7. That category is still filling its 30-day observation window: 1 days of observed history at the previous scan, 2 at this one. The score rises as the window fills, whether or not the server changes.

  • 27 Jul 26 0
    • We updated how we score, so this day's move reflects our rubric, not a change to the server See what changed → functional
  • 26 Jul 26 66

    First indexed and scored.

Diagnostics

Diagnostic detail from the automated scan of this channel: what the scanner observed at each step, so you can see exactly where a check passed or failed. It is informational only and never changes the trust score.

Captured 3 Aug 2026 · Probed https://fiatdock.com/mcp

TLS valid

Negotiated TLS 1.3 with TLS_AES_128_GCM_SHA256 .

Subject Issuer Valid from Valid until Key Signature Serial
CN=fiatdock.com CN=YE1,O=Let's Encrypt,C=US 10 Jun 2026 8 Sept 2026 ECDSA 256 ECDSA-SHA384 5ec4558932d71f9cec4d794f6114b9ce56d
SANs: fiatdock.com
CN=YE1,O=Let's Encrypt,C=US (CA) CN=Root YE,O=ISRG,C=US 3 Sept 2025 2 Sept 2028 ECDSA 384 ECDSA-SHA384 5ddd70dd31f801c85c186a7a04b80afe
CN=Root YE,O=ISRG,C=US (CA) CN=ISRG Root X2,O=Internet Security Research Group,C=US 13 May 2026 2 Sept 2032 ECDSA 384 ECDSA-SHA384 872165fc34b6e5fba8add5b3705fb53a
CN=ISRG Root X2,O=Internet Security Research Group,C=US (CA) CN=ISRG Root X1,O=Internet Security Research Group,C=US 13 May 2026 2 Sept 2032 ECDSA 384 SHA256-RSA 6c8f1dc727c7117f7baf853ac980f9cd
DNSSEC secure

Validation of fiatdock.com. Secure

Zone DS Keys Algorithms Outcome
. trust_anchor 20326, 38696 8, 8 Verified
com. present 19718 13 Verified
fiatdock.com. present 60796 8 Verified
fiatdock.com. Verified address RRset verified with the apex keys
Authentication No authorisation required

The endpoint answered without asking for a token. Anyone who knows the URL can reach it.

Result No authorisation required
HTTP status 200
Header Value
strict-transport-security max-age=31536000; includeSubDomains
content-security-policy default-src 'self'; script-src 'self'; style-src 'self' 'unsafe-inline'; img-src 'self' data:; font-src 'self'; connect-src 'self'; frame-src 'none'; frame-ancestors 'none'; base-uri 'none'; form-action 'self'; object-src 'none'
x-content-type-options nosniff
x-frame-options DENY
referrer-policy strict-origin-when-cross-origin
permissions-policy geolocation=(), microphone=(), camera=()
Transports 2 probes
Transport URL Outcome Status Location
streamable-http https://fiatdock.com/mcp Verified 200
http (plaintext) http://fiatdock.com/mcp HTTPS enforced 308 https://fiatdock.com/mcp
MCP tools — 18 exposed · ~3,175 tokens

The tools this component advertises to a client, with an estimated token cost for each. Expand a tool to see its parameters and schema. The per-tool counts are indicative and are not scored directly; the schema's total context footprint is one signal in Schema Quality & AI Usability.

Tool Tokens
address_intel ~174

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.

NameTypeReqDescription
addressstringyesA 40-hex EVM address (0x…) on Base to enrich
NameTypeReqDescription
addressstringyesThe queried address
asOfstringyesISO 8601 read time
ethBalancestringyesNative ETH balance as a decimal string
isContractbooleanyestrue if the address has bytecode on Base
isErc20booleanyestrue if it is an ERC-20 token contract
networkstringyesChain read (always base)
noncenumberyesOutgoing transaction count (account nonce)
securityobjectyesKeyless GoPlus address-security verdict
summarystringyesOne-line human-readable verdict
tokenyesERC-20 identity when isErc20, else null
typestringyeseoa | contract | erc20_contract
usdcBalancestringyesUSDC balance as a decimal string

No examples provided.

block_number ~81

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.

Input schema present but exposes no named parameters.

NameTypeReqDescription
asOfstringyesISO 8601 read time
blockNumbernumberyesLatest block height on Base
networkstringyesChain read (always base)
timestampnumber|nullyesUnix seconds of the latest block (null if unavailable)
timestampIsostring|nullyesISO 8601 of the latest block time (null if unavailable)

No examples provided.

call_service ~198

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

NameTypeReqDescription
argsobjectJSON payload to send to the service (e.g. an MCP JSON-RPC request body) — shape is defined by that service
idstringyesListing id (svc_…) to invoke, from search_services
NameTypeReqDescription
okbooleanyestrue when the underlying service returned a 2xx
resultThe service's response body — parsed JSON when it returned JSON, otherwise the raw text
routedThroughGatewaybooleanyestrue if PAID (settled 99% seller / 1% FiatDock via /s/:id); false if FREE/first-party direct
servicestringyesListing id that was invoked
statusnumberyesHTTP status returned by the service (or the gateway)

No examples provided.

create_offramp_session ~566

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 ($1.00 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.

NameTypeReqDescription
callbackUrlstringOptional public https URL stored for a future provider with status webhooks — the current provider sends none, so no push will arrive and no callback secret is issued. Poll get_order_status instead
cryptoAmountnumberyesUSDC amount to sell
customerIdstringStable agent/customer id
emailstringOwner's account email. If provided, the checkout link is ALSO emailed to this address automatically (you still receive it in checkoutUrl); the response echoes emailedTo to confirm
fiatCurrencystringe.g. EUR, default EUR
networkstringUSDC network, default base
providerstringLicensed fiat provider. `mtpelerin` is the only provider on this server and the default — omit this field. It settles by SEPA bank transfer across the SEPA zone (incl. Portugal); its order status is…
refstringOptional referral code (1-64 chars: letters, digits, _ or -)
walletAddressstringOptional SELL source wallet (0x…, EIP-55 checked) — pre-fills the widget; required with walletCode/walletHash
walletCodestringOptional Mt Pelerin address lock, part 1: 4-digit code (1000-9999). Requires walletHash + walletAddress
walletHashstringOptional Mt Pelerin address lock, part 2: base64 signature of 'MtPelerin-<code>' by the agent's OWN wallet key (never shared with us). Requires walletCode
NameTypeReqDescription
checkoutUrlstringyesBranded checkout URL (valid ~2 hours) — forward to the human owner
customerKeystringReturned ONCE on the first session with a new customerId — store securely
customerKeyNotestringHow to use customerKey
emailedTostringPresent when an `email` was supplied and email is configured: the checkout link was also emailed to this address (best-effort)
notestringNext-step instructions
partnerOrderIdstringyesOrder id — track it with get_order_status
providerstringLicensed fiat provider handling this session (e.g. mtpelerin)

No examples provided.

create_onramp_session ~521

Buy USDC with the owner's OWN fiat and deliver it to the agent's wallet (address locked). Returns checkoutUrl + partnerOrderId. Paid endpoint ($1.00 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.

NameTypeReqDescription
callbackUrlstringOptional public https URL stored for a future provider with status webhooks — the current provider sends none, so no push will arrive and no callback secret is issued. Poll get_order_status instead
customerIdstringStable agent/customer id
emailstringOwner's account email. If provided, the checkout link is ALSO emailed to this address automatically (you still receive it in checkoutUrl); the response echoes emailedTo to confirm
fiatAmountnumberyesFiat amount to spend
fiatCurrencystringe.g. EUR, default EUR
networkstringUSDC network, default base
providerstringLicensed fiat provider. `mtpelerin` is the only provider on this server and the default — omit this field. It settles by SEPA bank transfer across the SEPA zone (incl. Portugal); its order status is…
refstringOptional referral code (1-64 chars: letters, digits, _ or -)
walletAddressstringyesAgent wallet that receives USDC (0x…, EIP-55 checked)
walletCodestringOptional Mt Pelerin address lock, part 1: 4-digit code (1000-9999). Requires walletHash
walletHashstringOptional Mt Pelerin address lock, part 2: base64 signature of 'MtPelerin-<code>' by the agent's OWN wallet key (never shared with us). Locks the widget to walletAddress. Requires walletCode
NameTypeReqDescription
checkoutUrlstringyesBranded checkout URL (valid ~2 hours) — forward to the human owner
customerKeystringReturned ONCE on the first session with a new customerId — store securely
customerKeyNotestringHow to use customerKey
emailedTostringPresent when an `email` was supplied and email is configured: the checkout link was also emailed to this address (best-effort)
notestringNext-step instructions
partnerOrderIdstringyesOrder id — track it with get_order_status
providerstringLicensed fiat provider handling this session (e.g. mtpelerin)

No examples provided.

eth_balance ~104

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.

NameTypeReqDescription
addressstringyesA 40-hex EVM address (0x…) to read the ETH balance of
NameTypeReqDescription
addressstringyesThe queried address
asOfstringyesISO 8601 read time
ethstringyesETH balance as a decimal string (18 dp, trimmed)
networkstringyesChain read (always base)
weistringyesETH balance in wei (string; may exceed Number range)

No examples provided.

gas_price ~79

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.

Input schema present but exposes no named parameters.

NameTypeReqDescription
asOfstringyesISO 8601 read time
gweinumberyesCurrent gas price in gwei
networkstringyesChain read (always base)
weiPerGasstringyesCurrent gas price in wei (string; may exceed Number range)

No examples provided.

get_order_status ~41

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

NameTypeReqDescription
partnerOrderIdstringyesOrder id returned when the session was created
NameTypeReqDescription
createdAtstringISO 8601 session creation time
customerIdstringCustomer id the session was created with
isBuyOrSellstringOrder direction
refstringReferral code if one was set
statusstringyesSESSION_CREATED -> PROCESSING -> COMPLETED | FAILED | CANCELLED | EXPIRED
updatedAtstringISO 8601 time of the last status update (static under the current provider — no webhook exists, so the order stays SESSION_CREATED; ADR-0050)

No examples provided.

get_quote ~148

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).

NameTypeReqDescription
cryptoAmountnumberUSDC amount (required for SELL)
fiatAmountnumberFiat amount (for BUY)
fiatCurrencystringe.g. EUR, default EUR
networkstringUSDC network, default base
sidestringSELL = USDC to fiat, BUY = fiat to USDC
NameTypeReqDescription
asOfstringISO timestamp of the quote
fiatCurrencystringFiat currency of the quote
networkstringUSDC network the quote assumes
notestringCaveats — youReceive is net of provider fees; the x402 session fee is separate
providerFixedFeenumberProvider-reported fixed fee component
providerNetworkFeenumberProvider-reported network delivery fee (0 on Base)
ratenumberyesExchange rate used (fiat per USDC)
sidestringyesQuote direction
sourcestringWhere the price came from (the provider's own conversion API)
youReceivestringyesAmount received NET of all provider fees, e.g. '87.78 EUR' — this is the number to decide on
youSendstringyesAmount the sender pays, e.g. '100 USDC'

No examples provided.

get_service ~78

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.

NameTypeReqDescription
idstringyesListing id (svc_…) from search_services
NameTypeReqDescription
callHintstringPlain-language instruction for how an agent invokes this listing
categorystringCategory slug (data, search, finance, dev, productivity, ai, web, other)
createdAtstringISO 8601 listing creation time
descriptionstringFull description
feeBpsnumberEffective gateway commission in basis points right now: 0 during the seller's first-month launch waiver (buyer pays the FULL price directly to the seller), else 100 (1%). PAID listings only (ADR-0022…
firstPartybooleanPlatform's own featured listing (official)
gatewayUrlstring|nullyesAbsolute URL to reach it: the FiatDock gateway https://…/s/:id (PAID — invoke via call_service, 99/1 split) OR the listing's own MCP endpoint (FREE/first-party — call directly). null for stdio (npm p…
idstringyesListing id (svc_…) — pass to get_service / call_service
installobjectReady-to-use local launch spec for stdio listings (npx -y <package>)
listingTypestring"http" (hosted Streamable-HTTP endpoint) or "stdio" (an npm package agents run locally via npx; always free, not remotely callable)
mcpEndpointstringReal MCP endpoint — present only for FREE/first-party (direct) listings
mcpToolstringFor a first-party listing served by FiatDock's own MCP: the exact tool name to call on that endpoint
namestringyesService name
networksarrayChain slugs the service settles on
packageNamestringnpm package name — present only on stdio listings; install with npx -y <packageName>
priceUsdnumberyesPrice per call in US dollars (0 = free)
ratingobjectVerified-purchase rating aggregate: { count, average (1-5) }
reviewsarrayRecent verified-purchase reviews, newest first
sellerIdstringOpaque seller id that owns the listing
sellerNamestringSeller display name, if set
statusstringListing status: pending | verified | suspended
summarystringOne-line summary
tagsarrayFree-text tags
trustResetAtstringISO time the listing was last demoted to pending after its endpoint or price changed (ADR-0043 bait-and-switch guard) — absent if never
verifiedbooleanyesVerified seller (KYC + active badge) or first-party (platform-vouched)
x402PriceUsdnumberREAL per-call x402 price when the endpoint sits behind FiatDock's own paywall (priceUsd is 0 there because such listings are not gateway-routed) — budget from THIS field when present

No examples provided.

search_services ~147

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.

NameTypeReqDescription
categorystringFilter by category slug: data, search, finance, dev, productivity, ai, web, other
qstringFree-text search over name, summary, description and tags
sortstringSort order (default newest; first-party listings are always featured first)
verifiedOnlybooleanOnly verified listings (KYC'd seller or first-party)
NameTypeReqDescription
countnumberyesNumber of listings returned
servicesarrayyesMatching listings (first-party featured first)

No examples provided.

stablecoin_intel ~141

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.

NameTypeReqDescription
assetstringStablecoin symbol (default USDC), e.g. USDC, USDT, DAI, USDe
NameTypeReqDescription
asOfstringyesISO 8601 time the snapshot was read
assetstringyesStablecoin symbol
namestringStablecoin full name
notestringHuman-readable caveat about the snapshot, if any
onBaseobjectyesCirculating supply on Base + its share of total
pegDeviationPctnumber|nullyesAbsolute deviation from $1.00, %
pegMechanismstringe.g. fiat-backed, crypto-backed, algorithmic
pegStatusstringyeson-peg | slight-deviation | off-peg | unknown
pegTypestringWhat the asset is pegged to (e.g. peggedUSD)
pricenumber|nullyesCurrent price in USD
sourcestringyesData source (e.g. DefiLlama)
topChainsarrayyesTop chains by circulating supply
totalCirculatingUsdnumber|nullyesTotal circulating supply (USD)

No examples provided.

token_metadata ~126

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.

NameTypeReqDescription
tokenstringyesAn ERC-20 contract address (0x…, 40 hex) on Base
NameTypeReqDescription
asOfstringyesISO 8601 read time
contractstringyesThe ERC-20 contract address queried
decimalsnumberyesToken decimals
namestring|nullyesToken name (null if the contract omits name())
networkstringyesChain read (always base)
symbolstring|nullyesToken symbol (null if the contract omits symbol())
totalSupplystring|nullyesTotal supply as a decimal string (null if unavailable)
totalSupplyAtomicstring|nullyesTotal supply in atomic units (string; null if unavailable)

No examples provided.

token_price ~156

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.

NameTypeReqDescription
chainstringChain slug: base (default), ethereum, polygon, arbitrum, optimism, bsc, avalanche
symbolstringMajor asset symbol (e.g. ETH, BTC) — used when no contract address is given
tokenstringERC-20 contract address (0x…) — preferred
NameTypeReqDescription
asOfstringyesISO 8601 time the snapshot was read
chainstringChain the quoted pair trades on
fdvUsdnumber|nullFully-diluted valuation in USD
liquidityUsdnumber|nullPair liquidity in USD
marketCapUsdnumber|nullMarket cap in USD
namestringToken name
notestringHuman-readable caveat about the snapshot, if any
priceChangeobjectPercent price change by window
priceUsdnumber|nullyesCurrent USD price (most-liquid pair)
queryobjectThe resolved lookup this snapshot answers (echoed so an agent can confirm what was priced)
recommendobjectRecommended paid next step (token_safety) — present for contract-address lookups where a rug/honeypot check matters
sourcestringyesData source
symbolstringToken symbol
topPairobjectThe most-liquid DEX pair used
txns24hobject24h buy/sell transaction counts on the top pair
volume24hUsdnumber|null24h trading volume in USD

No examples provided.

token_report ~205

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.

NameTypeReqDescription
chainstringChain slug: base (default), ethereum, polygon, arbitrum, optimism, bsc, avalanche
tokenstringyesERC-20 contract address (0x…) to report on
NameTypeReqDescription
addressstringyesThe ERC-20 contract address
asOfstringyesISO 8601 read time
namestring|nullyesToken name
networkstringyesChain slug the report is for (e.g. base)
notestringyesHuman-readable caveat
priceobjectyesPrice/liquidity from the most-liquid DEX pair (DexScreener)
safetyobjectyesOn-chain safety verdict (GoPlus) — same shape token_safety returns
sourcestringyesData sources
symbolstring|nullyesToken symbol
verdictstringyesHeadline safety verdict: safe | caution | danger

No examples provided.

token_safety ~178

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.

NameTypeReqDescription
chainstringChain slug: base (default), ethereum, polygon, arbitrum, optimism, bsc, avalanche
tokenstringyesERC-20 contract address (0x…) to screen
NameTypeReqDescription
asOfstringyesISO 8601 time the verdict was computed
buyTaxPctnumber|nullyesBuy tax %
chainstringChain the token was screened on
holderCountnumber|nullNumber of holders
isHoneypotbooleanyesToken cannot be sold (honeypot)
isMintablebooleanSupply can be minted
isOpenSourcebooleanyesContract source verified/open
isProxybooleanUpgradeable proxy contract
liquidityUsdnumber|nullDEX liquidity in USD
lpLockedPctnumber|nullLiquidity-pool tokens locked, %
namestringToken name
notestringHuman-readable caveat about the verdict, if any
priceUsdnumber|nullCurrent USD price, when a liquid pair exists
queryobjectThe resolved lookup this verdict answers
risksarrayyesEach detected risk: level (danger|caution), flag, detail
sellTaxPctnumber|nullyesSell tax %
sourcestringyesData source (e.g. GoPlus Security + DexScreener)
symbolstringToken symbol
tokenstringContract address that was screened
topHolderPctnumber|nullTop holder's share of supply, %
verdictstringyesOverall risk verdict
verdictReasonstringyesPlain-language explanation of the verdict

No examples provided.

tx_status ~117

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.

NameTypeReqDescription
txHashstringyesA 64-hex transaction hash (0x…) on Base
NameTypeReqDescription
asOfstringyesISO 8601 read time
blockNumbernumberyesBlock the tx was mined in
confirmationsnumberyesConfirmations as of the read (>=1)
fromstring|nullyesSender address (null if the node omits it)
gasUsedstringyesGas used by the tx (string)
networkstringyesChain read (always base)
statusstringyessuccess | failed (a pending/unknown tx returns 404, not this shape)
tostring|nullyesRecipient address (null for a contract-creation tx)
txHashstringyesThe transaction hash queried

No examples provided.

usdc_balance ~115

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.

NameTypeReqDescription
addressstringyesA 40-hex EVM address (0x…) to read the USDC balance of
NameTypeReqDescription
addressstringyesThe queried address
asOfstringyesISO 8601 read time
assetstringyesToken symbol (USDC)
atomicstringyesUSDC balance in atomic units (6 dp; string)
contractstringyesUSDC contract address on Base
networkstringyesChain read (always base)
usdcstringyesUSDC balance as a decimal string (trimmed)

No examples provided.