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

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 para descubrir métodos y documentación, y después seguir el flujo de registro HTTP 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
• Repositorio oficial: 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:

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

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

viem

• Documentación oficial: Documentación de viem
• Referencia de transportes: Transporte HTTP de viem y Transporte WebSocket de viem
• Repositorio oficial: wevm/viem

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

Transporte HTTP con API key

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:

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):

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.

wagmi

• Documentación oficial: createConfig de wagmi y Transporte HTTP de wagmi
• Repositorio oficial: wevm/wagmi

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

Configuración con API key

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

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
• Repositorio oficial: 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

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 en la guía de agentes de IA.

Próximos pasos

• Conecte un agente de IA para descubrir endpoints mediante MCP, llms.txt y OpenAPI.
• Siga la guía de registro programático para registrarse y crear una API key con una firma de billetera, o inicie sesión en la consola para crear una clave.
• Reglas de facturación para revisar la medición de unidades de cómputo (CU), los límites de frecuencia y los errores no facturados.