Neo N3 for MCP and HTTP clients

Neo N3 MCP Server

Use 25 focused tools for blockchain data, assets, wallets, transaction workflows, and contracts resolved by verified script hash, address, or live metadata.

🚀 Get Started 📚 Documentation

25 Tools

4 Resources

400+ Tests

0 CVEs

                            $
                             npx -y @r3e/neo-n3-mcp
                        
                            ✓ Neo N3 MCP Server started
                        
                            $
                             configure your MCP client transport
                        
                            ✓ 25 tools and 4 resources available

Powerful Features

A tested integration surface for Neo N3 applications and automation

🔗

Blockchain and Asset Tools

Query blocks, transactions, application logs, balances, NEP-17 transfers, NEP-11 holdings, fees, and confirmation state through 25 focused tools.

25 Tools 4 Resources Bounded RPC

🔐

Hardened HTTP and Wallets

Loopback-first HTTP, bearer authentication, exact CORS allowlists, body limits, strict write confirmation, encrypted wallet records, and restrictive file permissions.

Bearer Auth Zero CVEs 400+ Tests

💎

Smart Contract Integration

Inspect live manifests, verify deployment status, estimate fees, invoke methods, and deploy compiled contracts by script hash, address, or exact indexed name.

Deploy Invoke Monitor

💰

Token and NFT Data

Read NEP-17 balances and transfers, inspect NEP-11 balances and transfers, estimate transfer fees, broadcast confirmed writes, and claim GAS.

NEP-17 NEP-11 Fee Estimates

⚡

Developer Experience

Node.js 22 support, TypeScript declarations, deterministic MCP tests, current deployment documentation, and explicit live and stress suites.

Node 22+ TypeScript Examples

🚀

Deployment Baseline

Production and development images, Compose definitions, liveness and readiness routes, bounded logs, dependency audits, and release validation are included.

Docker Health Checks Release Gates

Code Examples

See Neo N3 MCP in action with real-world examples

Wallet Operations

Wallet Management

Create encrypted wallet records and query their on-chain balances.

// Query a provisioned account
const balance = await neo.callTool('get_balance', {
  network: 'testnet',
  address: accountAddress
});

console.log(balance.balance);

Smart Contracts

Contract Interaction

Verify a deployed contract and invoke a read-only method by script hash.

// Invoke smart contracts
const result = await neo.callTool('invoke_contract', {
  network: 'mainnet',
  contract: '0xd2a4cff31913016155e38e474a2c06d08be276cf',
  operation: 'symbol',
  args: []
});

console.log(result.stack);

Asset Transfers

Token Operations

Transfer NEP-17 tokens with automatic fee estimation and transaction confirmation.

// Transfer assets
const transfer = await neo.callTool('transfer_assets', {
  idempotencyKey: 'transfer-2026-07-11-001',
  network: 'testnet',
  toAddress: toAddr,
  asset: 'NEO',
  amount: '1'
});

console.log('TX ID:', transfer.txid);

Blockchain Data

Network Information

Access comprehensive blockchain data including blocks, transactions, and network status.

// Get blockchain info
const info = await neo.callTool('get_blockchain_info', {
  network: 'testnet'
});
const block = await neo.callTool('get_block', {
  network: 'testnet',
  hashOrHeight: info.height
});

console.log('Height:', info.height);
console.log('Hash:', block.hash);