Skip to content
MCP server

NimBooks

Read-only Nimiq accounting server: balances, statements, staking and draft payment links

Runs locallyStatus and history
Pricing
Free
Platforms
CLI, macOS, Windows
Runs
Locally
Version
1.3.1
Listing updated
3 days ago

About NimBooks

NimBooks is a free MCP server for finance and payments. It runs locally on your machine and is started by your AI client.

Everything here is a read or a pure function, and the README leads with what the server will not do: it never signs, holds no key material, builds or broadcasts nothing, and writes nothing. A payment request or stake draft comes back as a link, and only the payer's wallet can move money.

It reads the public Nimiq chain and, optionally, a NimBooks backup file opened read-only. The network surface is four public hosts: rpc.nimiqwatch.com, v2.nimiqwatch.com, a validator list endpoint, and api.coingecko.com for daily prices; it never calls the NimBooks site. The README adds a warning that a backup file can contain cashlink private keys and should be guarded like a wallet.

There are eleven tools, covering balance and flows, classified transactions, day-by-day statements priced at each day's close, payment request drafting and paid checks, and staking: position, pools ranked with fees, yield projections and rewards by pool. It runs locally with npx and Node 20, and --address sets a default account.

Install

Run in a terminal

claude mcp add nimbooks-mcp -- npx -y nimbooks-mcp

Add to claude_desktop_config.json

{
  "mcpServers": {
    "nimbooks-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "nimbooks-mcp"
      ]
    }
  }
}
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "nimbooks-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "nimbooks-mcp"
      ]
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

{
  "servers": {
    "nimbooks-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "nimbooks-mcp"
      ]
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "nimbooks-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "nimbooks-mcp"
      ]
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "nimbooks-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "nimbooks-mcp"
      ]
    }
  }
}

Tools this server provides (11)

Taken from the project documentation; the running server may differ.

get_summary
Balance and money in and out over a window.
list_transactions
Classified transactions, newest first.
get_statement
Day-by-day statement priced at each day's close.
create_payment_request
Drafts a shareable payment link without signing.
draft_stake
Returns a link that opens the stake panel pre-filled.
check_request_paid
Checks whether a request has been paid.
list_invoices
Lists requests saved in a backup file.
get_staking
Shows the staked position, pool fee and net yield, and unstake clock.
list_validators
Ranks pools with fees and yields.
project_yield
Projects staking earnings year by year.
get_rewards
Rewards over a window, per pool.

What it does

Never signs
The package has no key handling, so no signature can be produced.
Priced statements
Day-by-day statements use each day's closing price.
Payment request links
Drafts a shareable request link and checks whether it was paid.
Staking views
Shows position, pool fees and net yield, unstake clock and rewards.
Four public hosts
The README lists the only network endpoints it contacts.

Good for

  • Ask how much came in last month and from whom
  • Draft a 25 NIM payment request for a retainer
  • Check whether a payment request was paid
  • Compare staking pools by fee and yield
  • Total staking rewards earned this year

Pricing

Free

Free; no account

Prices change. Check nimbooks.subimpact.net before you buy.

NimBooks FAQ

Can it spend funds?

No. It never signs or sends anything.

Does it use a NimBooks server?

No, the README says it never calls nimbooks.subimpact.net.

How many tools are there?

Eleven.

Do I need a backup file?

Only list_invoices needs one, passed with --backup.

Is NimBooks free?

Yes. NimBooks is free to use.

How do I add NimBooks to Claude Code?

Run this command in your terminal: claude mcp add nimbooks-mcp -- npx -y nimbooks-mcp

What are the best alternatives to NimBooks?

The closest alternatives to NimBooks are Solana MCP by Vybe, Tapetide - Indian Stock Market MCP, Budget Tracker, Quantivex Research and Provyan.

Alternatives to NimBooks

  1. Remote MCP server exposing the Vybe Solana API to AI clients and code editors

    • 44 tools
    • Remote
    • 2.8K GitHub stars
    • Finance and payments
  2. Indian NSE and BSE stock market data for AI assistants through 48 MCP tools

    • 17 tools
    • Remote
    • Freemium
    • 150 GitHub stars
    • Finance and payments
  3. Budget Tracker

    MCP server

    Local MCP expense ledger that logs receipts and mileage, splits VAT and prepares rebilling

    • 14 tools
    • Remote
    • Freemium
    • 2 GitHub stars
    • Finance and payments
  4. Stock scores, what a price assumes, earnings quality and quiet profit revisions

    • 11 tools
    • Remote
    • Free
    • Finance and payments
  5. Provyan

    MCP server

    Backtested crypto signal results on 94 coins, with luck odds and sources

    • 4 tools
    • Remote
    • Free
    • Finance and payments
  6. TribuJus

    MCP server

    Read-only access to UK bank accounts, cards and transactions via TrueLayer Open Banking

    Not checked yet
    • 5 tools
    • Remote
    • Open source
    • Legal and government