Beaconchain MCP for AI Agents

Securely connect your AI agents and chatbots (Claude, ChatGPT, Cursor, etc) with Beaconchain MCP or direct API to analyze validator performance, track latest block proposals, monitor network participation, and surface live staking stats through natural language.

Beaconchain logoBeaconchain
Api Key

Beaconchain is a real-time analytics platform for Ethereum 2.0's Beacon Chain. It provides detailed insights into validators, blocks, and overall network performance.

37 Tools

Try Beaconchain now

Type what you want done — sign in and watch it run live in the Tool Router playground.

TOOL ROUTER PLAYGROUND
Beaconchain
Try asking
TOOLS

Supported Tools

Every Beaconchain action and event your agent gets out of the box.

Get Chart

Retrieve chart visualizations from beaconcha.

Get Epoch

Retrieve aggregate metrics and status for a beacon chain epoch.

Get ETH1 Deposits by Transaction Hash

Retrieve all beacon chain validator deposit events associated with a specific execution-layer transaction hash.

Get ETH.Store Daily Aggregates

Retrieve ETH.

Get ERC-20 Token Balances

Retrieve a paginated list of ERC-20 token balances for a specific Ethereum address.

Get Execution Block

Retrieve one or more execution-layer blocks by block number from the Ethereum Beacon Chain.

Get Execution Produced Blocks

Retrieve execution-layer blocks attributed to one or more producers.

Get Latest State

Retrieve the latest known Ethereum Beacon Chain network state.

Get Network Performance

Retrieve aggregated network performance metrics for the Ethereum Beacon Chain.

Get Explorer Health

Check the health status of the beaconcha.

Get Validator Queues

Retrieve current queue metrics for Ethereum Beacon Chain validators.

Get Rocket Pool Validator

Retrieve Rocket Pool-specific metadata for validators including minipool status, node fee, smoothing pool status, and RPL stake metrics.

Get Slot

Retrieve detailed information about an Ethereum Beacon Chain slot.

Get Slot Attestations

Retrieve all attestations included in the beacon block for a specific slot.

Get Slot Attester Slashings

Retrieve all attester slashing operations included in the beacon block for a specific slot.

Get Slot Proposer Slashings

Retrieve all proposer slashing operations included in the beacon block for a specific slot.

Get Slot Voluntary Exits

Retrieve all voluntary exit operations included in the beacon block for a specific slot.

Get Sync Committee

Retrieve the sync committee membership for a given sync period.

Get Validator

Retrieve detailed information about an Ethereum Beacon Chain validator.

Get Validator Attestation Efficiency

Retrieve normalized attestation inclusion effectiveness for one or more validators.

Get Validator Attestations

Retrieve attestations observed for one or more validators within a bounded epoch window.

Get Validator Balance History

Retrieve per-epoch balance history for one or more Ethereum Beacon Chain validators.

Get Validator BLS Changes

Retrieve on-chain BLS-to-execution credential change messages (EIP-4881) for validators.

Get Validator Consensus Rewards

Retrieve consensus-layer rewards for one or more validators over multiple lookback windows.

Get Validator Daily Stats

Retrieve per-day statistics for a single Ethereum Beacon Chain validator by index.

Get Validator Deposits

Retrieve execution-layer deposit events for one or more validators.

Get Validator Execution Rewards

Retrieve execution-layer rewards (priority fees and MEV payments) for one or more validators.

Get Validator Income History

Retrieve a per-epoch income breakdown for one or more validators.

Get Validator Leaderboard

Retrieve the current top 100 validators ranked by 7-day consensus-layer rewards.

Get Validator Proposals

Retrieve beacon chain blocks proposed by one or more validators within a bounded epoch window.

Get Validators by Deposit Address

Retrieve validators that have made deposits from a specific execution-layer address.

Get Validators by Withdrawal Credentials

Retrieve validators whose withdrawal credentials match the provided value or execution-layer address.

Get Validators Proposal Luck

Retrieve proposal luck statistics for one or more Ethereum Beacon Chain validators.

Get Validators Queue

Retrieve current queue metrics for validators on the Ethereum Beacon Chain.

Get Validator Withdrawals

Retrieve withdrawal operations attributed to one or more validators within a bounded epoch window.

Post Validators

Retrieve validator information using a JSON request body for multiple validators.

Resolve ENS Name or Address

Resolve ENS (Ethereum Name Service) names to addresses and vice versa.

SETUP GUIDE

Connect Beaconchain MCP Tool with your Agent

1

Install Composio

typescript
npm install @composio/core ai @ai-sdk/openai @ai-sdk/mcp
Install the Composio SDK and Claude Agent SDK
2

Create Tool Router Session

typescript
import { Composio } from '@composio/core';

const composio = new Composio({ apiKey: 'your-api-key' });

console.log("Creating Tool Router session...");
const { mcp } = await composio.create('your-user-id');
console.log(`Tool Router session created: ${mcp.url}`);
Initialize the Composio client and create a Tool Router session
3

Connect to AI Agent

typescript
import { openai } from '@ai-sdk/openai';
import { experimental_createMCPClient as createMCPClient } from '@ai-sdk/mcp';
import { generateText, stepCountIs } from 'ai';

const client = await createMCPClient({
  transport: {
    type: 'http',
    url: mcp.url,
    headers: { 'x-api-key': 'your-composio-api-key' }
  }
});

const tools = await client.tools();

const { text } = await generateText({
  model: openai('gpt-4o'),
  tools,
  messages: [{ role: 'user', content: 'Check the health of the current Ethereum node' }],
  stopWhen: stepCountIs(5)
});

console.log(`Agent: ${text}`);
Use the MCP server with your AI agent
SETUP GUIDE

Connect Beaconchain API Tool with your Agent

1

Install Composio

typescript
npm install @composio/openai
Install the Composio SDK
2

Initialize Composio and Create Tool Router Session

typescript
import OpenAI from 'openai';
import { Composio } from '@composio/core';
import { OpenAIResponsesProvider } from '@composio/openai';

const composio = new Composio({
  provider: new OpenAIResponsesProvider(),
});
const openai = new OpenAI({});
const session = await composio.create('your-user-id');
Import and initialize Composio client, then create a Tool Router session
3

Execute Beaconchain Tools via Tool Router with Your Agent

typescript
const tools = session.tools;
const response = await openai.responses.create({
  model: 'gpt-4.1',
  tools: tools,
  input: [{
    role: 'user',
    content: 'Check the health status of the Ethereum beacon node.'
  }],
});
const result = await composio.provider.handleToolCalls(
  'your-user-id',
  response.output
);
console.log(result);
Get tools from Tool Router session and execute Beaconchain actions with your Agent

Why Use Composio?

AI Native Beaconchain Integration

  • Supports both Beaconchain MCP and direct API based integrations
  • Structured, LLM-friendly schemas for reliable tool execution
  • Rich coverage for reading, writing, and querying your Beaconchain data

Managed Auth

  • Built-in API key management and secure handling for Beaconchain
  • Central place to manage, scope, and revoke Beaconchain access
  • Per user and per environment credentials instead of hard-coded keys

Agent Optimized Design

  • Tools are tuned using real error and success rates to improve reliability over time
  • Comprehensive execution logs so you always know what ran, when, and on whose behalf

Enterprise Grade Security

  • Fine-grained RBAC so you control which agents and users can access Beaconchain
  • Scoped, least privilege access to Beaconchain resources
  • Full audit trail of agent actions to support review and compliance
FAQ

Frequently asked questions

Yes, Beaconchain requires you to configure your own API key credentials. Once set up, Composio handles secure credential storage and API request handling for you.

Yes! Composio's Tool Router enables agents to use multiple toolkits. Learn more.

Composio is SOC 2 and ISO 27001 compliant with all data encrypted in transit and at rest. Learn more.

Composio maintains and updates all toolkit integrations automatically, so your agents always work with the latest API versions.

Start with Beaconchain.It takes 30 seconds.

Managed auth, hosted MCP servers, and every Beaconchain tool your agent needs.Free to start.

Start building