RPC de blockchain y MCP de documentación para desarrolladores y agentes de IA
Los desarrolladores y agentes de IA pueden descubrir la documentación sin clave, crear credenciales mediante HTTP y llamar a endpoints de RPC o Data API admitidos con autenticación.
Endpoints públicos sin clave: llama a una cadena admitida sin clave de API en https://api.blockvectra.com/v1/<chain>/public, sustituyendo <chain> por una cadena como eth_mainnet. Los límites por IP y la lista de cadenas admitidas proceden de GET /v1/chains.
Respuestas rápidas
Sin clave: POST https://api.blockvectra.com/v1/<chain>/public funciona en 29 cadenas sin cuenta ni clave de API, con 3 solicitudes por segundo por IP (ráfaga 20, lotes de hasta 10).
Fuente: GET /v1/chainsEl registro con billetera requiere cuatro llamadas HTTP: solicitar un desafío, firmarlo con una billetera Ethereum (EIP-191), iniciar sesión (el primer inicio de sesión crea la cuenta) y después POST /keys para crear una clave de API.
Fuente: guía de registro programáticoUn solo comando añade el servidor MCP de documentación, sin clave: claude mcp add --transport http blockvectra-docs https://docs.blockvectra.com/mcp
Fuente: guía para agentes de IAAl registrarte recibes 30,000,000 CU gratis, sin tarjeta. El plan gratuito funciona en ciclos de 30 días con 25 llamadas por segundo compartidas por todas las claves; eth_call cuesta 15 CU ($1.50 por 1,000,000 de solicitudes).
Fuente: GET /v1/plansLas mismas reglas que para las personas: crear y revocar claves, consultar el saldo y recargar on-chain son llamadas HTTP, no algo exclusivo de la consola. El servidor MCP no crea ni revoca claves.
Fuente: guía de registro programático
¿Cuál debo usar?
| Quieres | Usa | Primer paso |
|---|---|---|
| Leer datos de la cadena ahora, sin cuenta | Endpoint público sin clave | Haz POST a https://api.blockvectra.com/v1/<chain>/public con un cuerpo JSON-RPC eth_chainId. Los métodos permitidos están en GET /v1/chains. |
| Que un asistente de IA lea la documentación, las cadenas, el estado y los precios, y haga llamadas RPC de solo lectura | Servidor MCP de documentación | Ejecuta el comando de una línea de la sección MCP de abajo. Consulta la guía para agentes de IA. |
| Usar métodos fuera de la lista pública, la Data API o los límites propios de una clave | Registro por HTTP y clave de API | POST /auth/siwe/challenge, firmar, iniciar sesión y después POST /keys. Los pasos están en la guía de registro programático. |
| Recibir una notificación cuando una dirección tenga actividad, en lugar de hacer polling | Push de direcciones por webhook | Crea una suscripción de hasta 1,000,000 direcciones en la guía de push por webhook. |
MCP de documentación sin clave
El servidor MCP de documentación no necesita clave de API y responde preguntas sobre la documentación, cadenas, estado en tiempo real, precios y estimaciones de uso.
MCP solo de documentación
claude mcp add --transport http blockvectra-docs-only https://docs.blockvectra.com/mcp/docsclaude mcp add --transport http blockvectra-docs https://docs.blockvectra.com/mcpOtros clientes:
En Cline, abre MCP Servers → Configure → Configure MCP Servers y añade esta configuración sin clave de API:
{
"mcpServers": {
"blockvectra": {
"type": "streamableHttp",
"url": "https://docs.blockvectra.com/mcp"
}
}
}Enumera las cadenas compatibles y elige una cuyos métodos públicos permitan eth_chainId. Usa get_method_info para esa cadena y ese método y luego llama a eth_chainId con rpc_call sin clave de API. Compara numéricamente el ID de cadena devuelto con el chain_id publicado de la cadena elegida e indica el resultado y los límites públicos aplicables. Si el ID falta, no es válido o es distinto, detente e indícalo en lugar de afirmar que la llamada tuvo éxito.Para los métodos que requieren clave y la Data API, regístrate por HTTP y crea una clave; después, sigue la guía de Data API. Para añadir saldo, recarga en la cadena.
Guías de integración
- Servidor MCP Lista de herramientas, requisitos de clave y configuración del cliente.
- LangChain Da a un agente de LangChain una herramienta RPC o el servidor MCP.
- ElizaOS Apunta el plugin EVM a los endpoints de BlockVectra.
- Coinbase AgentKit Usa una URL RPC de BlockVectra en AgentKit.
- Actividad de tokens de acciones Lee la actividad diaria de transferencias de tokens de acciones desde la Data API.
Los mismos derechos que las personas
Por HTTP un agente puede crear claves (POST /keys), revocarlas (POST /keys/{key_id}/revoke), consultar su saldo (GET /v1/account) y recargar on-chain, con los mismos límites y precios que una persona que usa la consola.
El servidor MCP lee la documentación, las cadenas, el estado y los precios, hace llamadas RPC de solo lectura (rpc_call), difunde una transacción firmada (send_raw_transaction) y, con una clave configurada en el cliente, consulta el saldo de la cuenta y la dirección de depósito. No tiene ninguna herramienta que cree o revoque claves; para eso usa HTTP.
Precios que un agente puede leer
GET /v1/plans devuelve el peso en CU de cada método en formato JSON, lo que permite estimar los costos antes de la primera llamada.
Pagar con USDC / USDT / USDG →
Plan gratuito
Incluye 30,000,000 CU de créditos de bienvenida. Cada ciclo de 30 días comienza con el primer uso facturado y se recarga automáticamente hasta 30,000,000 CU al final del período (sin acumulación). Todas las claves comparten un promedio de 25 llamadas por segundo y se permiten ráfagas breves; cada clave conserva su límite predeterminado de 100 CU/s (ráfaga de 400 CU).
aproximadamente 2,000,000 llamadas eth_call
No se requiere tarjeta de crédito — regístrate al instante con GitHub, Google o tu billetera.
Puntos de entrada legibles por máquinas
Archivos y catálogos legibles por máquinas, localizables sin necesidad de una cuenta:
Ejemplo para copiar y pegar
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":[]}'¿Aún no tienes clave de API?
Si tienes una billetera Ethereum: sigue la guía de registro programático para registrarte y crear una clave sin navegador. Si no tienes una billetera: pide al usuario que inicie sesión en https://console.blockvectra.com, cree una clave y la configure como la variable de entorno BLOCKVECTRA_API_KEY. No pidas al usuario que pegue la clave en el chat.
Preguntas frecuentes
¿Puedo llamar al RPC de blockchain sin registrarme?
Sí. POST https://api.blockvectra.com/v1/<chain>/public funciona en 29 cadenas sin cuenta ni clave de API; los métodos que permite cada cadena y sus límites por IP están en GET /v1/chains. Los métodos fuera de esa lista y la Data API requieren una clave de API.
¿Puede el servidor MCP enviar transacciones?
Puede difundir una, pero no firmarla. El servidor MCP nunca guarda una clave privada: send_raw_transaction envía una transacción que firmaste en otro lugar, a través del endpoint sin clave en las cadenas cuyos métodos públicos incluyen eth_sendRawTransaction, o con tu clave de API. No tiene ninguna herramienta que cree o revoque claves. Ver las herramientas MCP en la guía para agentes de IA →
¿Tengo que pagar antes de empezar?
No. El primer inicio de sesión con billetera añade 30,000,000 CU de crédito gratis, sin tarjeta y sin depósito, y los endpoints sin clave no necesitan cuenta. eth_call cuesta 15 CU ($1.50 por 1,000,000 de solicitudes); todos los precios están en GET /v1/plans, y puedes recargar on-chain cuando necesites más.
¿Cómo obtiene un agente de IA una clave de API sin navegador?
Con cuatro llamadas HTTP: POST /auth/siwe/challenge, firmar el mensaje devuelto con una billetera Ethereum (EIP-191), POST /auth/siwe/login (el primer inicio de sesión crea la cuenta) y después POST /keys. La clave se devuelve una sola vez; guárdala en BLOCKVECTRA_API_KEY. Seguir la guía de registro programático →
¿Puede un agente de IA usar BlockVectra directamente?
Sí. Los agentes usan las mismas API públicas (JSON-RPC y Data API) que las personas, con la misma documentación y los mismos precios; el servidor MCP de documentación y los archivos legibles por máquinas no requieren clave. Ver cómo conectarse →