# NimBooks

> NimBooks is a free MCP server for finance and payments. Read-only Nimiq accounting server: balances, statements, staking and draft payment links. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Free
- **Platforms:** CLI, macOS, Windows, Linux
- **Website:** https://nimbooks.subimpact.net/mcp/
- **Repository:** https://github.com/subimpact/nimbooks-mcp
- **MCP Registry name:** io.github.subimpact/nimbooks-mcp
- **Categories:** finance and payments
- **Listing updated:** 2026-11-14

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

```sh
claude mcp add nimbooks-mcp -- npx -y nimbooks-mcp
```

### Claude Desktop (claude_desktop_config.json)

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

### Cursor (~/.cursor/mcp.json)

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

### VS Code (.vscode/mcp.json)

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

### Windsurf (~/.codeium/windsurf/mcp_config.json)

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

### Other clients (your client's MCP settings (most use this shape))

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

## Tools

- `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.

## 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

- [Solana MCP by Vybe](https://ai-powered.com/mcp/solana-mcp-by-vybe): Solana MCP by Vybe is an MCP server for finance and payments.
- [Tapetide - Indian Stock Market MCP](https://ai-powered.com/mcp/tapetide-indian-stock-market-mcp): Tapetide - Indian Stock Market MCP is a freemium MCP server for finance and payments.
- [Budget Tracker](https://ai-powered.com/mcp/budget-tracker-2): Budget Tracker is a freemium MCP server for finance and payments.
- [Quantivex Research](https://ai-powered.com/mcp/quantivex-research): Quantivex Research is a free MCP server for finance and payments.
- [Provyan](https://ai-powered.com/mcp/provyan): Provyan is a free MCP server for finance and payments.
- [TribuJus](https://ai-powered.com/mcp/tribujus): TribuJus is an open-source MCP server for legal and government.
- [L2WS](https://ai-powered.com/mcp/l2ws): L2WS is a paid MCP server for finance and payments.
- [Invoices](https://ai-powered.com/mcp/invoices): Invoices is a paid MCP server for files and documents.

---
Source: https://ai-powered.com/mcp/nimbooks
