# RPC de blockchain y MCP de documentación para desarrolladores y agentes de IA

> https://blockvectra.com/es/agents/

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/chains](https://api.blockvectra.com/v1/chains))
- El 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ático](https://docs.blockvectra.com/es/guides/programmatic-signup/))
- Un 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 IA](https://docs.blockvectra.com/es/guides/ai-agents/))
- Al 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/plans](https://console-api.blockvectra.com/v1/plans))
- Las 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](https://docs.blockvectra.com/es/guides/programmatic-signup/))

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

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

search_docs · read_doc

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

[MCP solo de documentación →](https://docs.blockvectra.com/en/guides/mcp-server/#docs-only-remote-http)

Un comando, sin clave de API:

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

Otros clientes:

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

En Cline, abre MCP Servers → Configure → Configure MCP Servers y añade esta configuración sin clave de API:

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

[Ver la guía para agentes de IA en la documentación →](https://docs.blockvectra.com/es/guides/ai-agents/)

Prueba una llamada RPC pública sin clave

```
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](https://docs.blockvectra.com/es/guides/programmatic-signup/); después, sigue la [guía de Data API](https://docs.blockvectra.com/es/api/data/). Para añadir saldo, [recarga en la cadena](https://docs.blockvectra.com/es/guides/agent-topup/).

## Guías de integración

- [Servidor MCP](https://docs.blockvectra.com/es/guides/mcp-server/) Lista de herramientas, requisitos de clave y configuración del cliente.
- [LangChain](https://docs.blockvectra.com/es/guides/langchain/) Da a un agente de LangChain una herramienta RPC o el servidor MCP.
- [ElizaOS](https://docs.blockvectra.com/es/guides/elizaos/) Apunta el plugin EVM a los endpoints de BlockVectra.
- [Coinbase AgentKit](https://docs.blockvectra.com/es/guides/coinbase-agentkit/) Usa una URL RPC de BlockVectra en AgentKit.
- [Actividad de tokens de acciones](https://docs.blockvectra.com/es/guides/stocks/) 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.

- [Abrir GET /v1/plans →](https://console-api.blockvectra.com/v1/plans)
- [Pagar con USDC / USDT / USDG →](https://blockvectra.com/es/pricing/#pay-with-usdt)

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

[Ver el plan gratuito y los precios →](https://blockvectra.com/es/pricing/#free)

## Puntos de entrada legibles por máquinas

Archivos y catálogos legibles por máquinas, localizables sin necesidad de una cuenta:

- [llms.txt del sitio principal](https://blockvectra.com/llms.txt)
- [llms.txt de la documentación](https://docs.blockvectra.com/llms.txt)
- [Copia en Markdown de cada página de la documentación](https://docs.blockvectra.com/md/es/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)
- [Referencia de errores](https://docs.blockvectra.com/es/errors/)

## Ejemplo para copiar y pegar

```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":[]}'
```

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

- [Ver la guía de registro programático →](https://docs.blockvectra.com/es/guides/programmatic-signup/)
- [Iniciar sesión en la consola](https://console.blockvectra.com/login/?next=%2Fkeys%2F)

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

### ¿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](https://console-api.blockvectra.com/v1/plans), y puedes [recargar on-chain](https://docs.blockvectra.com/es/guides/agent-topup/) 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 →](https://docs.blockvectra.com/es/guides/programmatic-signup/)

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