# RPC de blockchain y MCP de documentación para frameworks de agentes

> Source: https://docs.blockvectra.com/es/guides/agent-frameworks/

Configure RPC de blockchain en ElizaOS, viem, wagmi o Coinbase AgentKit con las recetas siguientes. Los desarrolladores y agentes de IA pueden usar primero el [MCP de documentación](https://docs.blockvectra.com/es/guides/ai-agents/#conectar-desde-clientes-mcp) para descubrir métodos y documentación, y después seguir el [flujo de registro HTTP](https://docs.blockvectra.com/en/guides/programmatic-signup/) independiente para crear una API key. Use esa clave en solicitudes RPC y Data API o en el encabezado `x-api-key` del cliente MCP para las herramientas que requieren clave; el acceso RPC sin clave se limita a los `public.methods` de cada cadena.

## ElizaOS

* Documentación oficial: [Documentación de elizaOS](https://elizaos.github.io/eliza/)
* Repositorio oficial: [elizaos/eliza](https://github.com/elizaos/eliza)

En elizaOS, las interacciones EVM se gestionan con el plugin `@elizaos/plugin-evm`. El plugin lee los endpoints del proveedor RPC de variables de entorno cuyos nombres siguen el patrón `ETHEREUM_PROVIDER_<NETWORK>`, o de la variable alternativa `EVM_PROVIDER_URL`.

Configure su archivo `.env` con la clave privada de su billetera y los endpoints RPC:

```bash
# EVM wallet private key for signing transactions
export EVM_PRIVATE_KEY=0x...

# Dedicated endpoints with API key
export ETHEREUM_PROVIDER_ETHEREUM=https://api.blockvectra.com/v1/eth_mainnet/${BLOCKVECTRA_API_KEY}
export ETHEREUM_PROVIDER_BASE=https://api.blockvectra.com/v1/base_mainnet/${BLOCKVECTRA_API_KEY}

# Keyless public RPC endpoint
# export ETHEREUM_PROVIDER_ETHEREUM=https://api.blockvectra.com/v1/eth_mainnet/public
```

Incluya `@elizaos/plugin-evm` en la configuración del personaje de su agente:

```json
{
  "name": "DeFiAgent",
  "plugins": ["@elizaos/plugin-evm"]
}
```

## viem

* Documentación oficial: [Documentación de viem](https://viem.sh/docs/clients/public.html)
* Referencia de transportes: [Transporte HTTP de viem](https://viem.sh/docs/clients/transports/http.html) y [Transporte WebSocket de viem](https://viem.sh/docs/clients/transports/websocket.html)
* Repositorio oficial: [wevm/viem](https://github.com/wevm/viem)

En viem, configure los transportes del cliente con `http()` o `webSocket()`.

### Transporte HTTP con API key

```typescript
import { createPublicClient, http } from "viem";
import { mainnet } from "viem/chains";

export const client = createPublicClient({
  chain: mainnet,
  transport: http(`https://api.blockvectra.com/v1/eth_mainnet/${process.env.BLOCKVECTRA_API_KEY}`),
});
```

### Transporte HTTP con endpoint público sin clave

Para solicitudes de lectura con métodos públicos permitidos sin API key:

```typescript
import { createPublicClient, http } from "viem";
import { mainnet } from "viem/chains";

export const publicClient = createPublicClient({
  chain: mainnet,
  transport: http("https://api.blockvectra.com/v1/eth_mainnet/public"),
});
```

### Transporte WebSocket

El transporte WebSocket (`webSocket(...)`) está disponible en las cadenas con `ws: true` en `GET /v1/chains`, como Robinhood Chain (`robinhood_mainnet`):

```typescript
import { createPublicClient, webSocket } from "viem";

export const wsClient = createPublicClient({
  transport: webSocket(`wss://api.blockvectra.com/v1/robinhood_mainnet/${process.env.BLOCKVECTRA_API_KEY}`),
});
```

Para conocer los parámetros de conexión y los tipos de suscripción, consulte la [guía de suscripciones WebSocket](https://docs.blockvectra.com/en/guides/websocket-subscriptions/).

## wagmi

* Documentación oficial: [createConfig de wagmi](https://wagmi.sh/core/api/createConfig) y [Transporte HTTP de wagmi](https://wagmi.sh/core/api/transports/http)
* Repositorio oficial: [wevm/wagmi](https://github.com/wevm/wagmi)

En wagmi, pase la URL RPC de BlockVectra al mapa `transports` dentro de `createConfig`.

### Configuración con API key

```typescript
import { createConfig, http } from "wagmi";
import { mainnet } from "wagmi/chains";

export const config = createConfig({
  chains: [mainnet],
  transports: {
    [mainnet.id]: http(`https://api.blockvectra.com/v1/eth_mainnet/${process.env.BLOCKVECTRA_API_KEY}`),
  },
});
```

### Configuración con endpoint público sin clave

```typescript
import { createConfig, http } from "wagmi";
import { mainnet } from "wagmi/chains";

export const config = createConfig({
  chains: [mainnet],
  transports: {
    [mainnet.id]: http("https://api.blockvectra.com/v1/eth_mainnet/public"),
  },
});
```

## Coinbase AgentKit

* Documentación oficial: [Documentación de Coinbase AgentKit](https://docs.cdp.coinbase.com/agentkit/docs/welcome)
* Repositorio oficial: [coinbase/agentkit](https://github.com/coinbase/agentkit)

Coinbase AgentKit usa proveedores de billetera para ejecutar acciones on-chain. En TypeScript, `ViemWalletProvider` de `@coinbase/agentkit` encapsula un `WalletClient` estándar de viem, lo que permite dirigir la ejecución de transacciones y las consultas RPC a través de los endpoints de BlockVectra.

### Configuración con ViemWalletProvider

```typescript
import { AgentKit, ViemWalletProvider } from "@coinbase/agentkit";
import { createWalletClient, http } from "viem";
import { privateKeyToAccount } from "viem/accounts";
import { mainnet } from "viem/chains";

const account = privateKeyToAccount(process.env.WALLET_PRIVATE_KEY as `0x${string}`);

const client = createWalletClient({
  account,
  chain: mainnet,
  transport: http(`https://api.blockvectra.com/v1/eth_mainnet/${process.env.BLOCKVECTRA_API_KEY}`),
});

const walletProvider = new ViemWalletProvider(client);

export const agentKit = await AgentKit.from({
  walletProvider,
});
```

Para operaciones de lectura con métodos permitidos, configure `http("https://api.blockvectra.com/v1/eth_mainnet/public")`.

## MCP remoto

Si su agente se conecta mediante el Model Context Protocol (Streamable HTTP MCP), conéctelo al endpoint del servidor MCP de BlockVectra:

`https://docs.blockvectra.com/mcp`

Para obtener instrucciones de configuración de clientes para Claude Code, Cursor, VS Code, Codex, Gemini CLI, OpenAI Responses API y Windsurf, consulte [Conexión desde clientes MCP](https://docs.blockvectra.com/es/guides/ai-agents/#conectar-desde-clientes-mcp) en la guía de agentes de IA.

## Próximos pasos

* [Conecte un agente de IA](https://docs.blockvectra.com/es/guides/ai-agents/) para descubrir endpoints mediante MCP, llms.txt y OpenAPI.
* [Siga la guía de registro programático](https://docs.blockvectra.com/en/guides/programmatic-signup/) para registrarse y crear una API key con una firma de billetera, o [inicie sesión en la consola](https://console.blockvectra.com/login/?next=%2Fkeys%2F) para crear una clave.
* [Reglas de facturación](https://docs.blockvectra.com/es/guides/billing-rules/) para revisar la medición de unidades de cómputo (CU), los límites de frecuencia y los errores no facturados.