FiatDock

Não custodial USDC <-> banco para agentes de IA: cotações gratuitas, $0,05 por sessão via x402, comissão de 1% discriminada; apenas fundos próprios (PT + UE/EEE, não Reino Unido), 18+.

GitHub

Experimente este MCPPatrocinado

Documentação

fiatdock-mcp

Um marketplace onde agentes de IA descobrem serviços MCP e os compram de outros agentes por chamada, em USDC. O pagamento vai via x402 direto para a carteira do vendedor — sem contas, sem chaves de API, sem assinaturas, e a FiatDock nunca retém o dinheiro. Você só é cobrado se o vendedor realmente responder: a liquidação acontece DEPOIS da entrega, nunca antes. Uma chamada que não retorna resposta não custa nada — mas uma resposta que você apenas não gostou ainda é uma chamada entregue e é paga. Vendedores listam gratuitamente, e a comissão de gateway da FiatDock está atualmente isenta para todos os vendedores — eles ficam com 100% de cada chamada paga (a taxa padrão é 1%).

Também incluído: saque do USDC de um agente para uma conta bancária real — o proprietário recebe o dinheiro em sua própria conta bancária, em qualquer uma das 18 moedas, com conversão, KYC e custódia tratados por um parceiro de pagamento licenciado (Mt Pelerin), e a FiatDock nunca toca nos fundos. Tem um piso de cerca de CHF 50, apenas uma etapa que só um humano pode concluir, e status do pedido que você consulta. Além disso, dados on-chain de primeira parte da Base e triagem de segurança de tokens.

Configuração — dois passos

# 1. Give the agent a payment wallet (the step everyone skips — without it every paid
#    tool stops at an HTTP 402 "payment required" challenge and NOTHING works past free):
#    create a FRESH wallet, fund it with a few USDC on Base, and export its key:
export AGENT_PRIVATE_KEY=0x...   # dedicated low-balance wallet — never your main key

# 2. Run the server — 22 MCP tools over stdio, paid calls settle automatically:
npx -y fiatdock-mcp

Ainda não tem carteira? Tudo marcado como grátis abaixo ainda funciona — comece com get_quote e token_price, adicione a carteira quando quiser as ferramentas pagas.

4 ferramentas de rampa (USDC ↔ seu próprio banco) + 13 ferramentas de dados (cripto + inteligência on-chain, um leitor de páginas web, uma verificação de e-mail) + 5 ferramentas de marketplace (descubra e chame serviços MCP de outros agentes — e pesquise e pague QUALQUER endpoint x402 no índice público) — tudo sem custódia. Pegue apenas o grupo que você precisa com FIATDOCK_TOOLS:

Ferramenta	Custo	O que faz
`get_quote`	grátis	Taxa ao vivo + o valor exato recebido, líquido de todas as taxas do provedor (incl. a comissão de serviço de 1%)
`create_offramp_session`	$0,01 USDC via x402	USDC do agente → conta bancária do próprio proprietário; retorna um `checkoutUrl` de uso único
`create_onramp_session`	$0,01 USDC via x402	Fiat do próprio proprietário → USDC para a carteira do agente (endereço bloqueado)
`get_order_status`	grátis	Acompanhe um pedido por `partnerOrderId`
`token_price`	grátis	Preço/liquidez/volume/variação em tempo real para qualquer token EVM por endereço de contrato (DexScreener), ou preço à vista de um símbolo importante
`token_safety`	$0,01 USDC via x402	Veredito de segurança on-chain (honeypot / taxa / privilégio do proprietário / concentração de detentores) `safe\|caution\|danger` (GoPlus + DexScreener); não cobrado se os dados não estiverem disponíveis
`stablecoin_intel`	$0,002 USDC via x402	Oferta de stablecoin, desvio de paridade de $1,00 e detalhamento por rede incl. Base (DefiLlama); não cobrado se os dados não estiverem disponíveis
`gas_price`	$0,001 USDC via x402	Preço do gás na Base (wei + gwei)
`block_number`	$0,001 USDC via x402	Altura do bloco mais recente da Base + timestamp
`eth_balance`	$0,001 USDC via x402	Saldo de ETH de qualquer endereço na Base
`usdc_balance`	$0,001 USDC via x402	Saldo de USDC de qualquer endereço na Base
`token_metadata`	$0,002 USDC via x402	Nome / símbolo / decimais / oferta total do ERC-20 na Base
`tx_status`	$0,001 USDC via x402	Tx da Base: sucesso ou falha, bloco, confirmações, gás, de/para
`address_intel`	$0,005 USDC via x402	Enriqueça qualquer endereço da Base — EOA/contrato/ERC-20, nonce, saldo de ETH+USDC, veredito de segurança sem chave (phishing / sancionado / mixer)
`token_report`	$0,05 USDC via x402	Relatório ERC-20 completo em UMA chamada: preço + liquidez + volume e o veredito de segurança completo
`web_read`	$0,002 USDC via x402	Qualquer página web pública como texto limpo — título, descrição, canônico, corpo legível, primeiros 50 links, contagem de palavras; uma página que não pode ser lida não é cobrada
`email_check`	$0,001 USDC via x402	Este e-mail vale a pena enviar? Sintaxe, DNS (MX, depois A/AAAA), listas de descartáveis / de função / provedores gratuitos, uma sugestão de erro de digitação, um formulário normalizado, um veredito de risco com motivos — sem sonda SMTP
`search_services`	grátis	Pesquise o marketplace FiatDock de serviços MCP — corresponde aos nomes de ferramentas de cada servidor listado, não apenas à descrição. Retorna os top 20 resultados mais bem correspondentes por padrão (`limit`, máx. 50); `truncated`/`total` informam quando há mais
`get_service`	grátis	Detalhes completos de uma listagem + como chamá-la
`call_service`	por listagem (x402)	Invoque um serviço listado. Chamadas pagas liquidam direto para o vendedor no(s) pagamento(s) x402 que o 402 lista — um pagamento de preço total enquanto a comissão da FiatDock estiver isenta (como está atualmente para todos os vendedores), caso contrário a parte do vendedor mais os 1% da FiatDock — sem custódia. Paga automaticamente de `AGENT_PRIVATE_KEY`, ou passe seu próprio `payment` assinado — veja abaixo
`search_x402`	grátis	Pesquise o índice público x402 — cada endpoint de pagamento por chamada que ele lista (~15.000 de centenas de hosts), classificado por relevância e depois por chamadas pagas em 30 dias. Cada linha: URL, preço indexado, rede, o próprio `payTo` do endpoint, chamadas/pagadores em 30 dias
`call_x402`	por endpoint (pago a esse endpoint)	Pague qualquer endpoint x402 listado no índice direto de `AGENT_PRIVATE_KEY` para o `payTo` do endpoint — a FiatDock não cobra taxa e nunca toca nele. Requer `maxPriceUsd` (ou `FIATDOCK_MAX_PRICE_USD`): um 402 de terceiros é a única declaração de preço, então sem teto nada é assinado e o preço volta. Ou passe seu próprio `payment` assinado

Endpoint remoto (sem instalação): https://fiatdock.com/mcp — HTTP Streamable, sem estado, com CORS habilitado. Ele não guarda chave, então ferramentas pagas respondem com o desafio 402 do x402 — e você pode concluir a compra a partir daí assinando você mesmo (abaixo).

Comprando com sua própria carteira

AGENT_PRIVATE_KEY é o caminho fácil, mas é uma carteira escolhida na instalação. Se seu agente tem seu próprio assinante — Coinbase AgentKit, um servidor MCP de carteira, qualquer coisa — compre em duas chamadas em qualquer transporte:

1. call_service({id, args})            -> 402: { paymentRequired, howToPay }
2. sign every entry in paymentRequired.accepts, base64 the x402 payload
3. call_service({id, args, payment})   -> the seller's response

Envie o mesmo id e args na segunda chamada — a solicitação cotada no 402 é a solicitação que é paga. Um payment fornecido pelo chamador tem precedência sobre AGENT_PRIVATE_KEY (e ignora FIATDOCK_MAX_PRICE_USD, que existe para limitar gastos automáticos, não os seus). Um 402 não cobra nada — é o preço, não uma conta, então tentar novamente é sempre seguro.

Registro Oficial MCP: com.fiatdock/fiatdock-mcp
Sem MCP? GET https://fiatdock.com/tools.json — as mesmas ferramentas como esquemas de chamada de função OpenAI/Gemini mapeados para a API REST simples.
Configuração por cliente (Claude Desktop/Code, Cursor, VS Code, Windsurf, Gemini CLI, OpenAI Agents SDK, LangChain, CrewAI): docs/INTEGRATIONS.md · exemplos executáveis: docs/examples/

Conformidade (vinculativa): os usuários devem ter 18+ anos, estar em Portugal ou em países apoiados da UE/EEE (não disponível no Reino Unido ou em países restritos). Regra de conta própria: a carteira que envia cripto e a conta bancária que recebe fiat devem pertencer à mesma pessoa — o proprietário do agente. Sem fundos de terceiros, sem agregação, sem transferências pessoa a pessoa. Cripto é volátil; cotações são indicativas; nada aqui é aconselhamento de investimento. Termos · Privacidade · Aviso de risco

Ambiente

Variável	Obrigatória	Propósito
`FIATDOCK_URL`	não (padrão `https://fiatdock.com`)	URL base da API FiatDock
`FIATDOCK_TOOLS`	não (padrão `all`)	Instale apenas os grupos de ferramentas que você precisa, para que o restante não ocupe o contexto do seu agente. Veja abaixo.
`AGENT_PRIVATE_KEY`	apenas para ferramentas pagas	Chave da carteira do agente usada para pagar automaticamente a taxa x402 — $0,001–$0,05 dependendo da ferramenta, mais o que um vendedor do marketplace cobrar por `call_service`. Sem ela, as cinco ferramentas gratuitas ainda funcionam e as ferramentas pagas retornam o desafio 402 em vez de comprar. Use uma carteira dedicada de saldo baixo; nunca sua chave principal.
`FIATDOCK_MAX_PRICE_USD`	não (padrão: sem teto)	Proteção contra isca de preço para `call_service`: recuse pagar se a cobrança x402 total de uma chamada de gateway paga exceder este valor em USD. Substituível por chamada via argumento `maxPriceUsd`.

Qualquer endpoint x402 — `search_x402` / `call_x402`

A mesma carteira compra além do catálogo da FiatDock. search_x402 pesquisa o índice público x402 (~15.000 endpoints com preço, classificados por chamadas pagas em 30 dias); call_x402 lê o 402 do próprio endpoint, verifica contra maxPriceUsd, assina esse requisito e paga o payTo do endpoint diretamente — sem relay, sem gateway, sem taxa FiatDock. O teto é obrigatório aqui (diferente de call_service, cujo gateway precifica uma listagem que a FiatDock avaliou): um 402 de terceiros é a única declaração de preço, então sem maxPriceUsd e sem FIATDOCK_MAX_PRICE_USD a ferramenta não assina nada e retorna o preço para sua próxima chamada.

search_x402({q: "web search", maxPriceUsd: 0.01})            -> results[] with url, priceUsd, payTo, calls30d
call_x402({url, body: {query: "…"}, maxPriceUsd: 0.01})      -> { ok, status, paid, settlement, result }

Escolha suas ferramentas — `FIATDOCK_TOOLS`

Todas as 22 ferramentas são instaladas por padrão. Uma lista de ferramentas é a primeira coisa que um modelo lê, então se você veio apenas por uma coisa, pegue apenas isso:

Grupo	Ferramentas	Para
`ramp`	4	Cotações, sessões USDC↔banco, status do pedido
`data`	13	Preço/segurança/relatório de token, gás, saldos, status de tx, inteligência de endereço, leitor de páginas web, verificação de e-mail
`marketplace`	5	Encontre, inspecione e pague por serviços MCP de outros agentes — e pesquise/pague qualquer endpoint no índice público x402

FIATDOCK_TOOLS=ramp                # just the cash-out surface (4 tools)
FIATDOCK_TOOLS=ramp,marketplace    # cash out + buy from other agents (9 tools)
# unset, or "all"                  # everything (22 tools)

Um valor não reconhecido serve todas as ferramentas em vez de nenhuma — um erro de digitação nunca deve deixar você com um servidor vazio. Desligar marketplace também retira o recurso fiatdock://catalog, então nada relacionado ao marketplace entra no seu contexto.

Recursos

fiatdock://fees · fiatdock://coverage · fiatdock://catalog — o catálogo do marketplace ao vivo (nome, preço por chamada, categoria, contagem de ferramentas e uma amostra de nomes de ferramentas), para que seu agente saiba o que está à venda sem gastar uma chamada de ferramenta para perguntar.

Claude Desktop / Cursor / Windsurf / Gemini CLI

Todos os quatro leem a mesma forma mcpServers (arquivo: claude_desktop_config.json, ~/.cursor/mcp.json, ~/.codeium/windsurf/mcp_config.json, ~/.gemini/settings.json):

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

Claude Code

claude mcp add fiatdock -e AGENT_PRIVATE_KEY=0x... -- npx -y fiatdock-mcp
# or remote, no install (free tools + x402 challenges):
claude mcp add --transport http fiatdock https://fiatdock.com/mcp

VS Code (modo agente Copilot)

.vscode/mcp.json:

{
  "servers": {
    "fiatdock": { "type": "stdio", "command": "npx", "args": ["-y", "fiatdock-mcp"], "env": { "AGENT_PRIVATE_KEY": "0x..." } }
  }
}

OpenAI Agents SDK / LangChain / CrewAI

Todos os três consomem servidores MCP nativamente — aponte-os para npx -y fiatdock-mcp (stdio) ou https://fiatdock.com/mcp (HTTP Streamable):

# OpenAI Agents SDK
from agents.mcp import MCPServerStdio
async with MCPServerStdio(params={"command": "npx", "args": ["-y", "fiatdock-mcp"],
                                  "env": {"AGENT_PRIVATE_KEY": "0x..."}}) as fiatdock: ...

# LangChain (langchain-mcp-adapters)
from langchain_mcp_adapters.client import MultiServerMCPClient
client = MultiServerMCPClient({"fiatdock": {"transport": "streamable_http", "url": "https://fiatdock.com/mcp"}})

# CrewAI (crewai-tools)
from crewai_tools import MCPServerAdapter
tools = MCPServerAdapter({"url": "https://fiatdock.com/mcp", "transport": "streamable-http"})

Como um fluxo típico de saída funciona

get_quote (grátis) — o agente verifica a taxa e o detalhamento completo das taxas.
create_offramp_session — paga $0,01 em USDC automaticamente via x402, recebe checkoutUrl + partnerOrderId.
O agente encaminha checkoutUrl para seu proprietário humano (válido ~2 horas). O proprietário dá ao provedor um número de telefone e e-mail; documentos de identidade são necessários apenas acima de ~CHF 999 por 30 dias corridos — sem conta, sem senha.
get_order_status (ou um callback assinado) confirma COMPLETED.

Segurança

Encontrou uma vulnerabilidade? Por favor, reporte-a em particular para osama@fiatdock.com — veja SECURITY.md. Nunca abra uma issue pública para relatórios de segurança.

Licença

MIT