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/chainsO 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áticoUm 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 IAO 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/plansAs 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ê quer | Use | Primeiro passo |
|---|---|---|
| Ler dados da rede agora, sem conta | Endpoint público sem chave | Faç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 leitura | Servidor MCP de documentação | Execute 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 chave | Cadastro por HTTP e chave de API | POST /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 polling | Push de endereços por webhook | Crie 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
claude mcp add --transport http blockvectra-docs-only https://docs.blockvectra.com/mcp/docsclaude mcp add --transport http blockvectra-docs https://docs.blockvectra.com/mcpOutros 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"
}
}
}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.
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 →