Neo N3 MCP Server

@r3e-network

About Neo N3 MCP Server

An MCP server for interacting with the Neo N3 blockchain.

Config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "neo-n3-mcp": {
      "command": "npx",
      "args": [
        "@r3e/neo-n3-mcp"
      ]
    }
  }
}

Tools

No tools detected

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

Overview

What is Neo N3 MCP Server?

A production-ready MCP server for Neo N3 blockchain integration, providing 27 tools, 3 fixed resources, and a parameterized block resource for wallet management, transaction lifecycle, asset transfers, contract deployment and interaction, and blockchain queries.

How to use Neo N3 MCP Server?

Install globally via npm install -g @r3e/neo-n3-mcp or locally via npm install @r3e/neo-n3-mcp. Run with npx @r3e/neo-n3-mcp or neo-n3-mcp (if installed globally). Configure using environment variables (NEO_NETWORK, NEO_MAINNET_RPC, NEO_TESTNET_RPC, etc.) or via Docker. MCP client configuration (e.g., Claude/Cursor) uses the neo-n3 server entry with npx -y @r3e/neo-n3-mcp and the desired environment.

Key features of Neo N3 MCP Server?

27 tools for blockchain interaction
3 fixed resources + parameterized block resource
Supports mainnet, testnet, or both networks
Wallet creation, import, and balance queries
Asset transfers and gas claiming
Contract deployment, invocation, and lookup
HTTP endpoints for health, metrics, and API access
Built-in rate limiting and secure logging
Docker support with compose configuration
N3Index-backed name resolution for contracts

Use cases of Neo N3 MCP Server?

Automate wallet management and asset transfers on Neo N3
Query blockchain data (blocks, transactions, application logs)
Deploy and invoke smart contracts via MCP tools or HTTP API
Monitor and manage NeoFS containers
Integrate Neo N3 capabilities into AI assistants (Claude, Cursor)

FAQ from Neo N3 MCP Server

What runtime or dependencies are required?

Node.js 18.x, 20.x, or 22.x is required. The server is published on npm and can also run via Docker.

How are private keys handled?

Private keys are encrypted and stored securely. Input validation is enforced, and sensitive operations require explicit confirmation.

Which Neo N3 networks are supported?

Mainnet, testnet, or both simultaneously. When set to both, stdio tool calls default to mainnet; HTTP mode requires a single network.

Where does contract name resolution happen?

The server includes a local famous-contract registry; unrecognized names can be resolved via the N3Index API (https://api.n3index.dev) before on-chain validation.

Is there rate limiting?

Yes, rate limiting is enabled by default (60 requests per minute, 1000 per hour) and can be configured via environment variables.

Frequently asked questions

What runtime or dependencies are required?

Node.js 18.x, 20.x, or 22.x is required. The server is published on npm and can also run via Docker.

How are private keys handled?

Private keys are encrypted and stored securely. Input validation is enforced, and sensitive operations require explicit confirmation.

Which Neo N3 networks are supported?

Mainnet, testnet, or both simultaneously. When set to `both`, stdio tool calls default to mainnet; HTTP mode requires a single network.

Where does contract name resolution happen?

The server includes a local famous-contract registry; unrecognized names can be resolved via the N3Index API (`https://api.n3index.dev`) before on-chain validation.

Is there rate limiting?

Yes, rate limiting is enabled by default (60 requests per minute, 1000 per hour) and can be configured via environment variables.

Comments

Basic information

More Other MCP servers

Activepieces

activepieces

AI Agents & MCPs & AI Workflow Automation • (~400 MCP servers for AI agents) • AI Automation / AI Agent with MCPs • AI Workflows & AI Agents • MCPs for AI Agents

23.2K

ACI: Open-Source Infra to Power Unified MCP Servers

aipotheosis-labs

ACI.dev is the open source tool-calling platform that hooks up 600+ tools into any agentic IDE or custom AI agent through direct function calling or a unified MCP server. The birthplace of VibeOps.

4.8K