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

> https://blockvectra.com/pt-br/agents/

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](https://api.blockvectra.com/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](https://docs.blockvectra.com/pt-br/guides/programmatic-signup/))
- 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](https://docs.blockvectra.com/pt-br/guides/ai-agents/))
- 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](https://console-api.blockvectra.com/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](https://docs.blockvectra.com/pt-br/guides/programmatic-signup/))

## 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](https://api.blockvectra.com/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](https://docs.blockvectra.com/pt-br/guides/ai-agents/). |
| 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](https://docs.blockvectra.com/pt-br/guides/programmatic-signup/). |
| 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](https://docs.blockvectra.com/pt-br/guides/webhook-push/). |

## 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

```bash
claude mcp add --transport http blockvectra-docs-only https://docs.blockvectra.com/mcp/docs
```

[MCP somente de documentação →](https://docs.blockvectra.com/en/guides/mcp-server/#docs-only-remote-http)

Um comando, sem chave de API:

```bash
claude mcp add --transport http blockvectra-docs https://docs.blockvectra.com/mcp
```

Outros clientes:

- [Instalar no Cursor](cursor://anysphere.cursor-deeplink/mcp/install?name=blockvectra&config=eyJ1cmwiOiJodHRwczovL2RvY3MuYmxvY2t2ZWN0cmEuY29tL21jcCJ9)
- [Configurar o Cline](https://docs.cline.bot/mcp/mcp-overview#manual-config)

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

```json
{
  "mcpServers": {
    "blockvectra": {
      "type": "streamableHttp",
      "url": "https://docs.blockvectra.com/mcp"
    }
  }
}
```

[Veja o guia para agentes de IA na documentação →](https://docs.blockvectra.com/pt-br/guides/ai-agents/)

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](https://docs.blockvectra.com/pt-br/guides/programmatic-signup/); depois, siga o [guia da Data API](https://docs.blockvectra.com/pt-br/api/data/). Para adicionar saldo, [recarregue on-chain](https://docs.blockvectra.com/pt-br/guides/agent-topup/).

## Guias de integração

- [Servidor MCP](https://docs.blockvectra.com/pt-br/guides/mcp-server/) Lista de ferramentas, requisitos de chave e configuração do cliente.
- [LangChain](https://docs.blockvectra.com/pt-br/guides/langchain/) Dê a um agente LangChain uma ferramenta RPC ou o servidor MCP.
- [ElizaOS](https://docs.blockvectra.com/pt-br/guides/elizaos/) Aponte o plugin EVM para os endpoints da BlockVectra.
- [Coinbase AgentKit](https://docs.blockvectra.com/pt-br/guides/coinbase-agentkit/) Use uma URL RPC da BlockVectra no AgentKit.
- [Atividade de tokens de ações](https://docs.blockvectra.com/pt-br/guides/stocks/) 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 →](https://console-api.blockvectra.com/v1/plans)
- [Pagar com USDC / USDT / USDG →](https://blockvectra.com/pt-br/pricing/#pay-with-usdt)

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

[Ver o plano gratuito e os preços →](https://blockvectra.com/pt-br/pricing/#free)

## Pontos de entrada legíveis por máquinas

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

- [llms.txt do site principal](https://blockvectra.com/llms.txt)
- [llms.txt da documentação](https://docs.blockvectra.com/llms.txt)
- [Cópia em Markdown de cada página da documentação](https://docs.blockvectra.com/md/pt-br/quickstart.md)
- [OpenAPI 3.1 — JSON-RPC](https://docs.blockvectra.com/openapi/json-rpc.yaml)
- [OpenAPI 3.1 — Data API](https://docs.blockvectra.com/openapi/data.yaml)
- [Catálogo de API RFC 9727](https://blockvectra.com/.well-known/api-catalog)
- [Referência de erros](https://docs.blockvectra.com/pt-br/errors/)

## Exemplo para copiar e colar

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

- [Veja o guia de cadastro programático →](https://docs.blockvectra.com/pt-br/guides/programmatic-signup/)
- [Entrar no console](https://console.blockvectra.com/login/?next=%2Fkeys%2F)

## 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](https://api.blockvectra.com/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 →](https://docs.blockvectra.com/pt-br/guides/ai-agents/)

### 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](https://console-api.blockvectra.com/v1/plans), e você pode [recarregar on-chain](https://docs.blockvectra.com/pt-br/guides/agent-topup/) 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 →](https://docs.blockvectra.com/pt-br/guides/programmatic-signup/)

### 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 →](https://docs.blockvectra.com/pt-br/guides/ai-agents/)
