Nodit Blockchain Context

Nodit MCP Server

A Model Context Protocol (MCP) server that connects AI agents and developers to structured, context-ready blockchain data across multiple networks through Nodit's Web3 infrastructure.

Overview

Nodit MCP Server simplifies how AI models and applications interact with blockchain ecosystems.
Instead of handling complex node RPCs, raw event logs, or chain-specific data structures, developers can access normalized, multi-chain blockchain data in a format optimized for AI reasoning and decision-making.

With Nodit's MCP, you can:

• Build AI agents that query, analyze, and act on real-time blockchain data across EVM-compatible and non-EVM networks.
• Develope Web3-integrated applications without requiring specialized blockchain development expertise.
• Leverage Nodit's reliable node infrastructure, Web3 Data APIs, and GraphQL indexing services through a unified access layer.
• Easily develop with blockchain MCP in both local and remote integration, depending on your workflow needs.

Supported networks include Ethereum, Base, Optimism, Arbitrum, Polygon, Aptos, Bitcoin, Dogecoin, TRON, XRPL, GIWA(Sepolia) and more.

Table of Contents

• List of Tools
• Features
• Prerequisites
• Running Local Nodit MCP Server
• Integrating Nodit Remote MCP Server
• Troubleshooting
• Example Prompts with Nodit MCP
• Scope & Limitations
• License

List of Tools

Nodit MCP Server provides tools enabling AI agents to dynamically discover, understand, and interact with Nodit's Web3 APIs and data infrastructure. The tools minimize token consumption and maintain a lightweight context by modularizing API interactions into distinct steps:

• Tools for Listing API Categories
  Retrieve a list of high-level API categories available.

  • list_nodit_api_categories

• Tools for Listing API Operations
  Fetch available operations within a selected category (Node APIs, Data APIs, Aptos Indexer APIs, Webhook APIs).

  • list_nodit_node_apis
  • list_nodit_data_apis
  • list_nodit_aptos_indexer_api_query_root
  • list_nodit_webhook_apis

• Tools for Getting API Specification
  Obtain detailed information for a specific API operation (parameters, request/response schema).

  • get_nodit_api_spec
  • get_nodit_aptos_indexer_api_spec

• Tools for Calling API
  Execute an API call using the operationId and validated parameters.

  • call_nodit_api
  • call_nodit_aptos_indexer_api

Nodit MCP Server communicates using the standard JSON-RPC over stdio protocol, following the Model Context Protocol (MCP) conventions. Currently, only stdio-based communication is supported for server-client interactions.

Features

The following are the key features and supported blockchain networks provided through Nodit MCP Server for AI agents and LLMs.
For detailed API specifications and usage guidelines, please refer to the Nodit Developer Documentation.

• RPC Node & Node APIs
  Access blockchain node endpoints through Nodit's professionally operated infrastructure.
  Supports real-time network queries, transaction submissions, smart contract interactions, and more.

• Web3 Data APIs
  High-level APIs for accessing meticulously indexed blockchain data.
  Includes processed datasets such as block and transaction details, token transfer histories, account-level transaction summaries, and asset movement details — information that would be difficult to assemble directly through raw RPC calls.

• GraphQL Indexer APIs (Aptos only)
  Query detailed Aptos blockchain activities through GraphQL endpoints.

• Supported Networks

  • EVM-Compatible: Ethereum, Arbitrum, Avalanche, Base, Chiliz, Kaia, Optimism, Polygon, BNB Chain, GIWA(Sepolia)
  • Non-EVM: Aptos, Bitcoin, Dogecoin, TRON, XRPL, Sui, Solana

Prerequisites

• Node.js 18+
• Nodit API Key (Sign up and get an API key at Nodit Console)

Running Local Nodit MCP Server

Using npx (Recommended)

npx @noditlabs/nodit-mcp-server@latest

Using local build

# Clone the repository
git clone --recurse-submodules https://github.com/noditlabs/nodit-mcp-server.git

# Move into the project directory
cd nodit-mcp-server

# Install dependencies
npm install

# Build the project
npm run build

Before starting, set your Nodit API key:

export NODIT_API_KEY=your-api-key

Then start the server:

node build/index.js

Communicating with the Local Server

Once the Nodit MCP Server is running locally, you can communicate with it using JSON-RPC over stdio.
Here’s how you can send a basic request to the server:

Example: List available tools

You can directly input the JSON-RPC payload:

{"method":"tools/list","params":{},"jsonrpc":"2.0","id":1}

Or, you can pipe the request using the echo command:

echo '{"method":"tools/list","params":{},"jsonrpc":"2.0","id":1}' | node build/index.js

Example: Call a specific tool (list_nodit_api_categories)

echo '{"method":"tools/call","params":{"name":"list_nodit_api_categories","arguments":{}},"jsonrpc":"2.0","id":1}' | node build/index.js

Connecting to Cursor IDE or Claude Desktop

Add the following configuration to your .cursor/mcp.json or claude_desktop_config.json:

• Cursor

  • MacOS: ~/.cursor/mcp.json
  • Windows: C:\Users\<Username>\.cursor\mcp.json

• Claude Desktop

  • MacOS: ~/Library/Application Support/Claude/claude_desktop_config.json
  • Windows: C:\Users\<Username>\AppData\Roaming\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "nodit": {
      "command": "npx",
      "args": ["@noditlabs/nodit-mcp-server@latest"],
      "env": {
        "NODIT_API_KEY": "****"
      }
    }
  }
}

🔔 Important
Replace **** with your actual Nodit API key.
If the API key is not configured properly, API requests will fail due to authentication errors.

Connecting to Claude CLI

You can also use Nodit MCP Server directly with Claude CLI for a quick setup.

Add Nodit MCP Server with the following commands:

# Add the Nodit MCP server
claude mcp add nodit-mcp-server npx @noditlabs/nodit-mcp-server

# Set API Key
export NODIT_API_KEY=your-api-key

# Start Claude with the Nodit MCP server enabled
claude

Integrating Nodit Remote MCP Server

If you’re using an AI tool that supports Remote MCP integration, you can connect to Nodit’s Remote MCP Server without running a local MCP server. This allows you to use Nodit MCP features directly within your AI environment.

Endpoint

Use the following endpoint to connect to the Nodit Remote MCP Server. Make sure to replace INSERT_YOUR_API_KEY with your actual Nodit API Key.

https://mcp.nodit.io/sse?apiKey=INSERT_YOUR_API_KEY

Connecting to Claude (Web)

If you’re on the Claude Enterprise, Pro, or Max plan, you can integrate the Remote MCP Server.

1. Go to Settings > Integrations, click the [Add custom integration] button.
2. Click the [Add more] button to integrate the new Remote MCP.
3. Insert the endpoint provided above to complete the setup.

Once the integration is complete, you’ll see that Nodit MCP has been added under the Search and Tools section on the Claude main screen.

Connecting to Cursor IDE

To connect Nodit MCP to Cursor IDE: 1. Open Preferences > Cursor Settings > MCP Tools. 2. Click [+ New MCP Server] to open the mcp.json configuration file.

You can also open and edit the mcp.json file directly at the following path:

• MacOS: ~/.cursor/mcp.json
• Windows: C:\Users\<Username>\.cursor\mcp.json

Add the following configuration to the mcpServers object. If you already have other MCP servers configured, separate each entry with a comma.

{
  "mcpServers": {
    "nodit": {
      "url": "https://mcp.nodit.io/sse?apiKey=INSERT_YOUR_API_KEY"
    }
  }
}

Once added, go back to MCP Tools in the Cursor interface and enable the nodit MCP by toggling it on. When the status shows “9 tools enabled” in green, the connection is complete.

Troubleshooting

Trouble running MCP via npx on Claude Desktop

If you are running the MCP server in combination with Claude Desktop or other tools that rely on a local Node.js installation, you may encounter issues due to:

• Multiple versions of Node.js installed (e.g., via Homebrew and package installer)
• Conflicting PATH environments
• Claude Desktop not recognizing the correct Node.js runtime

Follow the steps below to verify that Node.js 18+ is properly installed and recognized on your system.

1. Check your currently active Node.js version

Run the following command in your terminal to check the version:

node --version

You should see a version number starting with v18 or higher (e.g., v18.19.0).

If not, you may need to install a compatible version or switch to it.

[!TIP] Claude Desktop may not use the same Node.js version as your terminal. If you have multiple installations (e.g., via Homebrew, nvm, or direct installer),

---

README truncated. View full README on GitHub.