Log inSubmit server
Nimbooks MCP logo

Nimbooks MCP

Read Nimiq balances, transactions, statements, invoices, and staking data, plus draft payment requests and stake links without signing.

InstallRepositoryWebsite
Full README Compare alternatives Embed widget Claim this listing

Install Nimbooks MCP

Pick your client, then add it in one click or paste the config.

STDIONode.js
~/Library/Application Support/Claude/claude_desktop_config.json
claude_desktop_config.json
{
  "mcpServers": {
    "nimbooks-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "nimbooks-mcp"
      ]
    }
  }
}

Settings → Developer → Edit Config, merge this into mcpServers, then fully quit and reopen Claude Desktop.

Automated check passed— started and listed 11 tools correctly ().

Overview

nimbooks-mcp gives AI assistants read access to Nimiq books and public-chain data for balances, classified transactions, statements, payment requests, and staking. It can also create unsigned payment-request and stake links, but it never handles keys, signs transactions, broadcasts payments, or writes to books. The process runs locally and reads data from public Nimiq RPC, analytics, validator, and CoinGecko endpoints. Use it for finance and fintech workflows that need NIM history, tax-basis reporting, payment-status checks, or staking analysis without wallet custody.

Use cases

  • Review NIM income, expenses, fees, and rewards for a date range
  • Generate daily NIM and USD statements for tax reporting
  • Draft payment requests or pre-filled staking links
  • Check whether a request reference has been paid
  • Compare validator pools and inspect staking yield

Key features

  • Read-only Nimiq balance and transaction analysis
  • Classified history and daily tax-basis statements
  • Unsigned payment-request and stake-link drafting
  • Staking positions, validators, rewards, and projections
  • Backup-based invoice listing with cashlink data isolation

Tools11

What Nimbooks MCP lets your agent do. Expand a tool for its parameters.

Verified live~2.9k tokens of context

Security & health

What it can reach and how reliably it runs — from our own checks, not the maintainer’s claims.

ActiveLast checked

Recent health check succeeded.

What it can do

From the 11 tools this server returned when we ran it; 11 declare their own safety hints.

Handles credentials · 1Makes network requests · 3Read-only tools · 11
Network at startup3 connections
Files written at startupNone
Install scriptsNone
npm provenanceNot published
Package age60 days
Maintainers1

Observed 2026-11-13 in an isolated sandbox. A description of reach, not a security audit.

Supply-chain signal

No high-severity advisories surfaced by our automated scan.

Critical 0High 0Medium 0Low 0

Scanned 8h ago via OSV.dev · nimbooks-mcp (npm)

Adoption & maintenance

Factual signals from GitHub, npm, and our automated checks — not a rating.

npm downloads1.7kPackage downloads in the last 30 days.
Last commit3d agoMost recent push to the default branch.
Availability100%Our rolling endpoint + install checks that succeeded.
Install checkPassedOur sandbox started it and listed its tools.
Tools exposed11Callable tools this server registers over MCP.

How Nimbooks MCP works

What nimbooks-mcp does

nimbooks-mcp connects an AI assistant to a Nimiq address and exposes read-only financial and staking operations. It can report the live basic-account balance, classify transaction history, produce dated statements, inspect staking positions, compare validator pools, estimate projected yield, and retrieve staking rewards.

The server also supports two drafting operations. create_payment_request produces a shareable payment-request link, while draft_stake creates a link that opens the app's staking panel with values filled in. Neither operation signs, sends, queues, or marks a payment as complete. The server has no private-key, seed-phrase, or passphrase handling.

How it works

The process runs on the local machine and reads the public Nimiq chain through rpc.nimiqwatch.com. Staking and validator information comes from Nimiq Watch public data and the validator list used by NimBooks. Daily historical prices for statements come from CoinGecko's public API. Generated links contain the NimBooks address needed by the receiving app; creating a link does not contact that application server.

An optional NimBooks backup file supplies locally stored payment requests for list_invoices. The file is opened read-only, and cashlink private-key entries are discarded before any data can reach tool output. Without a backup, payment status can still be checked from the chain with check_request_paid.

Setup and configuration

Node.js 20 or newer is required. Install and run the package through npm with npx -y nimbooks-mcp --help, or clone the source, install dependencies, build it, and run the resulting dist/index.js file.

Use --address <NQ…> to set the default account address. This is optional because every tool accepts an address, but it allows questions to refer to the configured account without repeating it. Addresses may be formatted with or without spaces, in lowercase, or as 40 hexadecimal characters; checksum validation rejects malformed values.

Use --backup <path> to provide a NimBooks backup file for list_invoices. In NimBooks, create the file through Backup → Copy, then pass its path to the process. Treat the file like a wallet because it may contain cashlink private keys, even though this server does not expose those entries.

The README includes configurations for Claude Desktop and Claude Code using the npm command or an absolute path to the built JavaScript file.

Tools and capabilities

  • get_summary reports the current balance, money in and out, fees, rewards, transaction counts, and Nimiq Pay internal transfers over a date window.
  • list_transactions returns classified rows with direction, kind, counterparty, memo, and transaction hash.
  • get_statement provides daily activity and CoinGecko UTC closing prices for a month or year.
  • create_payment_request drafts a shareable payment request without signing it.
  • draft_stake drafts a pre-filled staking link without moving funds.
  • check_request_paid checks whether a request reference appears on chain.
  • list_invoices reads stored payment requests from the supplied backup.
  • get_staking, list_validators, project_yield, and get_rewards cover positions, pools, projected returns, and observed rewards.

Amounts are returned in exact Luna integers and decimal NIM strings. Staking balances are reported separately from the live basic-account balance. Nimiq Pay contract round trips are separated into internal inflow and outflow fields where the relevant contract data can be read.

Limitations and notes

Summary and statement operations inspect up to 1,000 newest transactions, while payment-status checks inspect up to 200. Transaction listings return 50 rows by default and allow up to 500. Pay-contract analysis can make an initial response take 15–25 seconds for a busy account.

CoinGecko's public price history covers only the last 365 days. Older statements retain exact NIM amounts but omit USD values. Missing daily prices are returned as null, and USD totals are withheld when the period has incomplete pricing. Reward data covers restaking pools, begins in January 2025, may lag by one day, and is capped at the newest 400 daily rows. Yield results are projections based on stated assumptions, not guarantees.

The server does not send transactions, manage a wallet, write to books, or replace a wallet application. Direct-payout staking rewards appear as ordinary incoming transactions rather than in the restaking rewards feed.

Read the full README View source on GitHub

Reviews

No reviews yet — be the first to share how it worked for you.

Frequently Asked Questions about Nimbooks MCP

nimbooks-mcp is an MCP server that connects AI assistants to Nimiq books and public-chain data. Its main tools read balances, classified transactions, statements, invoices, staking positions, validators, and rewards, while also drafting payment-request and stake links. It never handles keys, signs transactions, broadcasts payments, or writes to books.

Install it with Node.js 20 or newer by running `npx -y nimbooks-mcp --help`. You can also clone the repository, run `npm install`, build with `npm run build`, and launch the resulting `dist/index.js` file. The server accepts `--address` and optionally `--backup` arguments.

Yes, nimbooks-mcp works with Claude Desktop through its standard MCP configuration. Add an entry that runs `npx -y nimbooks-mcp` and optionally passes `--address` with the Nimiq account address, then restart Claude Desktop to load the tools.

No, nimbooks-mcp cannot send or sign Nimiq payments. It has no key handling and does not build, broadcast, or queue transactions. Its payment and staking tools only return links or drafts that require approval in a wallet or app.

Pass the backup path with `--backup <path>` to enable `list_invoices`. Create the file in NimBooks with Backup → Copy and store it carefully because it may contain cashlink private keys. The server opens the file read-only and does not expose cashlink key data.

Related MCP servers

All in Finance & Fintech All alternatives
Add a badge to your READMEShow it’s listed — live SVG, Markdown or HTML.

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:
Live Dynamic SVG PreviewNimbooks MCP AllMCPs Directory Badge
Markdown (GitHub README)
[![AllMCPs](https://allmcps.com/api/badge/nimbooks-mcp?style=directory)](https://allmcps.com/mcp/nimbooks-mcp)
HTML Embed
<a href="https://allmcps.com/mcp/nimbooks-mcp"><img src="https://allmcps.com/api/badge/nimbooks-mcp?style=directory" alt="Nimbooks MCP on AllMCPs" /></a>