Pular para o conteúdo

RPC de blockchain e MCP de documentação para desenvolvedores e agentes de IA

Desenvolvedores e agentes de IA podem explorar a documentação sem chave, criar credenciais via HTTP e chamar endpoints compatíveis de RPC ou Data API com autenticação.

Endpoints públicos sem chave: chame uma rede com suporte sem chave de API em https://api.blockvectra.com/v1/<chain>/public, substituindo <chain> por uma rede como eth_mainnet. Os limites por IP e a lista de redes com suporte vêm de GET /v1/chains.

Respostas rápidas

  • Sem chave: POST https://api.blockvectra.com/v1/<chain>/public funciona em 29 redes sem conta nem chave de API, a 3 requisições por segundo por IP (burst 20, lotes de até 10).

    Fonte: GET /v1/chains
  • O cadastro com carteira leva quatro chamadas HTTP: solicitar um desafio, assiná-lo com uma carteira Ethereum (EIP-191), fazer login (o primeiro login cria a conta) e então POST /keys para criar uma chave de API.

    Fonte: guia de cadastro programático
  • Um comando adiciona o servidor MCP de documentação, sem chave: claude mcp add --transport http blockvectra-docs https://docs.blockvectra.com/mcp

    Fonte: guia para agentes de IA
  • O cadastro dá 30,000,000 CU grátis, sem cartão. O plano gratuito funciona em ciclos de 30 dias com 25 chamadas por segundo compartilhadas por todas as chaves; eth_call custa 15 CU ($1.50 por 1,000,000 de requisições).

    Fonte: GET /v1/plans
  • As mesmas regras das pessoas: criar e revogar chaves, ler o saldo e recarregar on-chain são todas chamadas HTTP, não algo exclusivo do console. O servidor MCP não cria nem revoga chaves.

    Fonte: guia de cadastro programático

Qual devo usar?

Você querUsePrimeiro passo
Ler dados da rede agora, sem contaEndpoint público sem chaveFaça POST em https://api.blockvectra.com/v1/<chain>/public com um corpo JSON-RPC eth_chainId. Os métodos permitidos estão em GET /v1/chains.
Deixar um assistente de IA ler a documentação, as redes, o status e os preços, e fazer chamadas RPC somente leituraServidor MCP de documentaçãoExecute o comando de uma linha na seção MCP abaixo. Veja o guia para agentes de IA.
Usar métodos fora da lista pública, a Data API ou os limites próprios de uma chaveCadastro por HTTP e chave de APIPOST /auth/siwe/challenge, assinar, fazer login e então POST /keys. Os passos estão no guia de cadastro programático.
Ser notificado quando um endereço tiver atividade, em vez de fazer pollingPush de endereços por webhookCrie uma inscrição de até 1,000,000 endereços no guia de push por webhook.

MCP de documentação sem chave

O servidor MCP de documentação não precisa de chave de API e responde a perguntas sobre documentação, redes, status em tempo real, preços e estimativas de uso.

MCP somente de documentação

search_docs · read_doc
claude mcp add --transport http blockvectra-docs-only https://docs.blockvectra.com/mcp/docs
MCP somente de documentação →(em inglês)
Um comando, sem chave de API:
claude mcp add --transport http blockvectra-docs https://docs.blockvectra.com/mcp

Outros clientes:

No Cline, abra MCP Servers → Configure → Configure MCP Servers e adicione esta configuração sem chave de API:

{
  "mcpServers": {
    "blockvectra": {
      "type": "streamableHttp",
      "url": "https://docs.blockvectra.com/mcp"
    }
  }
}
Veja o guia para agentes de IA na documentação →
Teste uma chamada RPC pública sem chave
Liste as redes compatíveis e escolha uma cujos métodos públicos permitam eth_chainId. Use get_method_info para essa rede e esse método e depois chame eth_chainId com rpc_call sem chave de API. Compare numericamente o ID da rede retornado com o chain_id publicado da rede escolhida e informe o resultado e os limites públicos aplicáveis. Se o ID estiver ausente, for inválido ou diferente, pare e informe isso em vez de afirmar sucesso.

Para métodos que exigem chave e a Data API, cadastre-se via HTTP e crie uma chave; depois, siga o guia da Data API. Para adicionar saldo, recarregue on-chain.

Guias de integração

  • Servidor MCP Lista de ferramentas, requisitos de chave e configuração do cliente.
  • LangChain Dê a um agente LangChain uma ferramenta RPC ou o servidor MCP.
  • ElizaOS Aponte o plugin EVM para os endpoints da BlockVectra.
  • Coinbase AgentKit Use uma URL RPC da BlockVectra no AgentKit.
  • Atividade de tokens de ações Leia a atividade diária de transferências de tokens de ações na Data API.

Os mesmos direitos das pessoas

Por HTTP, um agente pode criar chaves (POST /keys), revogá-las (POST /keys/{key_id}/revoke), ler seu saldo (GET /v1/account) e recarregar on-chain, com os mesmos limites e preços de uma pessoa que usa o console.

O servidor MCP lê a documentação, as redes, o status e os preços, faz chamadas RPC somente leitura (rpc_call), transmite uma transação assinada (send_raw_transaction) e, com uma chave configurada no cliente, lê o saldo da conta e o endereço de depósito. Ele não tem nenhuma ferramenta que crie ou revogue chaves; use HTTP para isso.

Preços legíveis por agentes

GET /v1/plans retorna o peso em CU de cada método em formato JSON, permitindo estimar custos antes da primeira chamada.

Abrir GET /v1/plans →

Pagar com USDC / USDT / USDG →

Plano gratuito

Inclui 30,000,000 CU de créditos de boas-vindas. Cada ciclo de 30 dias começa com o primeiro uso faturado e é renovado automaticamente até 30,000,000 CU ao final do período (sem acúmulo). Todas as chaves compartilham uma média de 25 chamadas por segundo e rajadas curtas são permitidas; cada chave mantém seu limite padrão de 100 CU/s (rajada de 400 CU).

aproximadamente 2,000,000 chamadas eth_call

Sem necessidade de cartão de crédito — cadastre-se instantaneamente com GitHub, Google ou sua carteira.

Pontos de entrada legíveis por máquinas

Arquivos e catálogos legíveis por máquinas, localizáveis sem precisar de conta:

Exemplo para copiar e colar

export BLOCKVECTRA_API_KEY=rgw_your_api_key

curl -X POST https://api.blockvectra.com/v1/robinhood_mainnet \
  -H "content-type: application/json" \
  -H "x-api-key: $BLOCKVECTRA_API_KEY" \
  -d '{"jsonrpc":"2.0","id":1,"method":"eth_blockNumber","params":[]}'

Ainda não tem uma chave de API?

Se você tiver uma carteira Ethereum: siga o guia de cadastro programático para se cadastrar e criar uma chave sem navegador. Se você não tiver uma carteira: peça ao usuário para entrar em https://console.blockvectra.com, criar uma chave e defini-la como a variável de ambiente BLOCKVECTRA_API_KEY. Não peça ao usuário para colar a chave no chat.

Perguntas frequentes

Posso chamar o RPC de blockchain sem me cadastrar?

Sim. POST https://api.blockvectra.com/v1/<chain>/public funciona em 29 redes sem conta e sem chave de API; os métodos que cada rede permite e seus limites por IP estão em GET /v1/chains. Métodos fora dessa lista e a Data API exigem uma chave de API.

O servidor MCP pode enviar transações?

Ele pode transmitir uma, não assiná-la. O servidor MCP nunca guarda uma chave privada: send_raw_transaction envia uma transação que você assinou em outro lugar, pelo endpoint sem chave nas redes cujos métodos públicos incluem eth_sendRawTransaction, ou com a sua chave de API. Ele não tem nenhuma ferramenta que crie ou revogue chaves. Veja as ferramentas MCP no guia para agentes de IA →

Preciso pagar antes de começar?

Não. O primeiro login com carteira adiciona 30,000,000 CU de crédito grátis, sem cartão e sem depósito, e os endpoints sem chave não exigem conta. eth_call custa 15 CU ($1.50 por 1,000,000 de requisições); todos os preços estão em GET /v1/plans, e você pode recarregar on-chain quando precisar de mais.

Como um agente de IA obtém uma chave de API sem navegador?

Com quatro chamadas HTTP: POST /auth/siwe/challenge, assinar a mensagem retornada com uma carteira Ethereum (EIP-191), POST /auth/siwe/login (o primeiro login cria a conta) e então POST /keys. A chave é retornada uma única vez; guarde-a em BLOCKVECTRA_API_KEY. Siga o guia de cadastro programático →

Um agente de IA pode usar a BlockVectra diretamente?

Sim. Os agentes usam a mesma API pública JSON-RPC e Data API que as pessoas, com a mesma documentação e preços; o servidor MCP de documentação e os arquivos legíveis por máquinas não exigem chave. Veja como conectar →