Nimiq MCP Server

Nimiq MCP Server is an MCP server that provides read-only interaction with the Nimiq blockchain for AI models and MCP clients. It connects to Nimiq RPC endpoints, allowing developers, crypto analysts, and node operators to inspect on-chain state without executing state-changing transactions. The server exposes eighteen tools and three documentation resources covering account balances, transaction histories, block details, validator slot assignments, epoch data, and circulating token supply. Users can also run interactive staking calculations and full-text searches across Nimiq protocol, web client, and validator documentation directly inside an assistant interface. By operating entirely in read-only mode, it ensures safe inspection of blockchain data without risking private keys or funds. The server supports two integration modes: a zero-setup remote deployment over Server-Sent Events or a self-hosted local installation using Node.js. This setup enables language models like Claude to assist users with technical research, balance verification, staking yield estimates, and network consensus monitoring on the Nimiq network.

Category: Finance, Crypto & Payments

Tags: blockchain, cryptocurrency, nimiq, web3

Visit Nimiq MCP Server

How to install and configure Nimiq MCP Server

1. Choose between remote access or a local Node.js installation. 2. For remote access without local setup, add this configuration to your MCP client (such as claude_desktop_config.json): json { "mcpServers": { "nimiq": { "url": "https://nimiq-mcp.je-cf9.workers.dev/sse", "transport": "sse" } } } 3. For local installation, configure your client to run the package via npx: json { "mcpServers": { "nimiq": { "command": "npx", "args": ["nimiq-mcp"] } } } 4. If you require a custom RPC node, append flags like --rpc-url, --rpc-username, and --rpc-password to the arguments array. 5. Save the configuration file and restart your MCP client.

What you can do with Nimiq MCP Server

• Inspect Nimiq account balances and historical transactions by providing a specific wallet address or transaction hash. - Calculate prospective Proof-of-Stake staking yields and token accumulation using the built-in interactive staking calculator tool. - Query block details, block producer data, validator slots, and current epoch numbers directly from the blockchain head. - Search official Nimiq web client, validator, and protocol documentation to retrieve technical guides and OpenRPC schemas. - Monitor network consensus status, peer counts, active validator lists, and total circulating NIM token supply figures.

Key facts

• Open Source
• https://github.com/onmax/nimiq-mcp
• Finance, Crypto & Payments
• blockchain, cryptocurrency, nimiq, web3

Part of MCP Servers

How do I install Nimiq MCP Server?

You can run Nimiq MCP Server locally using npx or connect directly without local installation using its hosted remote Server-Sent Events endpoint. Both options are configured by adding the server details to your MCP client JSON configuration file, requiring only standard Node.js if you opt for local execution.

What can Nimiq MCP Server do?

The server provides eighteen read-only tools and three documentation resources. It allows AI models to fetch account balances, review transaction histories, examine block headers, audit active validators, calculate staking rewards, check circulating supply, and search Nimiq developer documentation without executing on-chain transactions or managing wallet keys.

Can Nimiq MCP Server send transactions?

No, Nimiq MCP Server is strictly designed for read-only operations. It does not support sending transactions or handling private keys for security reasons. Users can query blockchain state, balances, network health, and validator details, but state-modifying actions must be performed through a dedicated Nimiq wallet or client.

Which MCP clients work with Nimiq MCP Server?

Nimiq MCP Server follows the standard Model Context Protocol specification and works with any compatible client. This includes Claude Desktop, Cursor, and web-based applications that connect to MCP servers via local stdio processes using npx or via remote Server-Sent Events HTTP endpoints.

Is Nimiq MCP Server open source?

Yes, Nimiq MCP Server is open source and hosted on GitHub. Developers can inspect the source code, run custom builds, deploy it locally with custom RPC endpoints, or self-host the server on Cloudflare Workers using the repository instructions.