Nexus MCP Server

Enabling AI Agents to Interact with the Nexus Blockchain

Overview

The Nexus MCP Server is a bridge that enables AI agents to interact directly with the Nexus blockchain using the Model Context Protocol (MCP). It exposes blockchain functionality as MCP tools that can be accessed by any MCP-compatible AI system, including Claude and other leading LLMs.

👉 Read the full blog post to learn how Nexus is building the blockchain for the AI era, starting with MCP integration.

Features

• Query Blockchain Data: Get blocks, transactions, account balances, and more
• Smart Contract Interaction: Make read-only contract calls to query on-chain data
• Transaction Management: Submit signed transactions to the network
• Event Monitoring: Track and filter blockchain events via logs
• Easy AI Integration: Compatible with any MCP-enabled AI system

Available Tools

Quick Start

Installation

# Clone the repository
git clone https://github.com/nexus/mcp-for-nexus
cd mcp-for-nexus

# Install dependencies
npm install

# Configure environment
cp .env.example .env

# Start the server
npm run dev

Testing with the Client

Once your server is running, you can connect to it using the included test client:

# Using the test client (requires Redis for SSE transport)
node scripts/test-nexus-client.mjs http://localhost:3000

For local development, make sure Redis is installed and running:

# Install Redis (macOS)
brew install redis

# Start Redis
brew services start redis

# Verify Redis is running
redis-cli ping  # Should respond with "PONG"

Client Usage Example

// Example of calling blockchain tools from your application
import { Client } from "@modelcontextprotocol/sdk/client/index.js";
import { SSEClientTransport } from "@modelcontextprotocol/sdk/client/sse.js";

const transport = new SSEClientTransport(new URL(`http://localhost:3000/sse`));

const client = new Client(
  { name: "my-app", version: "1.0.0" },
  { capabilities: { prompts: {}, resources: {}, tools: {} } }
);

await client.connect(transport);

// Get blockchain info
const networkInfo = await client.callTool({
  name: "getNetworkInfo",
  arguments: {}
});

// Query an account balance
const balance = await client.callTool({
  name: "getBalance",
  arguments: { address: "0x1234567890abcdef1234567890abcdef12345678" }
});

// Get block information
const blockData = await client.callTool({
  name: "getBlock", 
  arguments: {
    blockNumber: "latest",
    fullTransactions: true
  }
});

Integrating with AI Systems

Claude Integration Example

//

... [View full README on GitHub](https://github.com/nexus-xyz/mcp-nexus-server#readme)