Ir para o conteúdo principal
SERVIDOR MCP

Ferramentas de wallet de agente para qualquer cliente MCP.

O servidor MCP oficial da Blockchain0x dá a um agente compatível com MCP o poder de ler carteiras, enviar USDC na Base e liquidar faturas. Conecte-se ao endpoint hospedado ou execute localmente com um único comando.

https://mcp.blockchain0x.com/mcp
O QUE É

Um servidor. Cinco ferramentas. Todo cliente MCP.

O Model Context Protocol é a forma padrão de clientes de IA - Claude Desktop, Cursor, Cline e outros - chamarem ferramentas externas. O servidor MCP da Blockchain0x expõe as carteiras dos seus agentes por meio desse padrão, para que qualquer cliente MCP possa movimentar dinheiro sem que você precise escrever uma integração personalizada.

O servidor é um proxy leve e stateless sobre a API da Blockchain0x. Ele não mantém fundos nem banco de dados; encaminha cada chamada de ferramenta para a API usando a chave que você fornece, e a permissão de gasto de cada agente ainda limita o que uma ferramenta pode fazer.

AS FERRAMENTAS

O que o agente pode chamar.

get_wallet

Leia a carteira de um agente: endereço, saldo de USDC na Base e metadados.

list_wallets

Liste as wallets de agente no seu workspace.

get_transaction

Pesquise uma transação pelo seu id e leia seu status on-chain.

send_payment

Envie USDC da carteira de um agente na Base, dentro da sua permissão de gasto.

settle_payment_request

Liquide uma solicitação de pagamento que você criou no dashboard, com prova on-chain.

COMO USAR

Duas formas de conectar.

1. Hospedado (Streamable HTTP)

Aponte seu cliente MCP para o endpoint hospedado e passe sua API key como um header Bearer. Não há nada para instalar.

CONFIGURAÇÃO DO CLIENTE MCP (HOSPEDADO)
{
  "mcpServers": {
    "blockchain0x": {
      "url": "https://mcp.blockchain0x.com/mcp",
      "headers": { "Authorization": "Bearer sk_live_..." }
    }
  }
}

2. Local (stdio, via npx)

Execute o servidor na sua própria máquina com npx @blockchain0x/mcp. Sua chave permanece no seu ambiente e nunca sai do seu dispositivo.

CONFIGURAÇÃO DO CLIENTE MCP (STDIO)
{
  "mcpServers": {
    "blockchain0x": {
      "command": "npx",
      "args": ["@blockchain0x/mcp"],
      "env": { "BLOCKCHAIN0X_API_KEY": "sk_live_..." }
    }
  }
}

Comece com uma chave sk_test_ na Base Sepolia e depois mude para sk_live_. A configuração completa está em a documentação; para cobrar pelas suas próprias ferramentas MCP, veja a receita de integração MCP.

SEGURANÇA

A permissão de gasto ainda se aplica.

  • O servidor nunca mantém seus fundos nem suas chaves; ele encaminha cada chamada para a API da Blockchain0x.
  • send_payment é verificado em relação ao limite por transação e à alocação por período do agente antes de ser liquidado, assim como qualquer outra chamada de API.
  • Use uma chave somente leitura (sem escopo de pagamento) para um agente que deve apenas ler carteiras e transações.
  • No stdio, a chave permanece no seu ambiente local. No hosted, ela trafega como um header Bearer sobre TLS e não é armazenada.
PERGUNTAS FREQUENTES

Três perguntas sobre o servidor MCP.

Onde o servidor MCP roda, e vocês veem a minha chave?

Duas formas de executá-lo. Hosted: conecte seu cliente MCP ao endpoint Streamable HTTP e envie sua API key como um header Bearer em cada requisição; o servidor é um proxy stateless que encaminha as chamadas para a API da Blockchain0x. Local (stdio): execute npx @blockchain0x/mcp na sua própria máquina e sua chave permanece no seu ambiente, sem nunca sair do seu dispositivo. Escolha stdio se preferir não enviar a chave para um endpoint hospedado.

Qual chave de API devo usar?

Uma chave sk_test_ opera na Base Sepolia (testnet) para que você possa integrar as ferramentas sem movimentar dinheiro real; troque para uma chave sk_live_ para a mainnet. Os escopos da chave determinam o que as ferramentas podem fazer - uma chave somente leitura pode chamar get_wallet, list_wallets e get_transaction, mas não send_payment.

Isso é o mesmo que o helper requirePayment?

Não. Esta página é sobre o servidor MCP da Blockchain0x, que fornece a um cliente MCP ferramentas de carteira de agente (ler carteiras, enviar USDC, liquidar faturas). requirePayment é um helper separado em @blockchain0x/mcp que você usa para definir um preço para suas PRÓPRIAS ferramentas MCP, retornando um desafio x402 402. Veja a receita de integração MCP para isso.

Dê uma wallet ao seu cliente MCP.

Crie uma wallet de agente, obtenha uma chave e aponte seu cliente para o servidor. Comece grátis.