NimBillDocs

Get started

Connect your AI

Set it up in 60 seconds.

The MCP server is the "nimbill-mcp" package on npm. It runs locally over stdio with Node.js 18.17+, and npx fetches it on first launch, so there is nothing to clone or build.

Fastest: let your agent install it

Paste this into Claude Code, Cursor, Windsurf or Antigravity. The agent installs nimbill-mcp from npm, wires it into its own config, and shows you its new wallet address. It will ask you for a passphrase to encrypt the wallet.

prompt for your agent
Set up the NimBill Agent Wallet MCP server for yourself. It is published on npm as "nimbill-mcp" (https://www.npmjs.com/package/nimbill-mcp) and needs Node.js 18.17 or newer.

1. Check that `node --version` is 18.17 or newer.
2. Register an MCP server named "nimbill" in this client's MCP config that runs `npx -y nimbill-mcp` with these environment variables:
   - NIMBILL_URL=https://nimbill.mblob.me
   - NIMBILL_WALLET_PASSPHRASE=<ask me for a passphrase; never invent one>
3. Reload the MCP servers (or tell me if I need to restart the app).
4. Call the wallet_status tool and show me your new NQ… address and balance.

Prefer to do it by hand? Pick your client below.

Claude Desktop

Add this to your claude_desktop_config.json (macOS: ~/Library/Application Support/Claude/claude_desktop_config.json, Windows: %APPDATA%\Claude\claude_desktop_config.json) and restart Claude Desktop:

claude_desktop_config.json
{
  "mcpServers": {
    "nimbill": {
      "command": "npx",
      "args": [
        "-y",
        "nimbill-mcp"
      ],
      "env": {
        "NIMBILL_URL": "https://nimbill.mblob.me"
      }
    }
  }
}

Claude Code (CLI)

Run this command in your terminal to register the NimBill Agent Wallet MCP server in Claude Code:

terminal
claude mcp add nimbill -e NIMBILL_URL=https://nimbill.mblob.me -- npx -y nimbill-mcp

Cursor

Save this in your project's .cursor/mcp.json (or globally in ~/.cursor/mcp.json), then enable the nimbill server under Cursor Settings → MCP:

.cursor/mcp.json
{
  "mcpServers": {
    "nimbill": {
      "command": "npx",
      "args": [
        "-y",
        "nimbill-mcp"
      ],
      "env": {
        "NIMBILL_URL": "https://nimbill.mblob.me"
      }
    }
  }
}

Google Antigravity / Windsurf / Other MCP Clients

Add the nimbill entry to your client's mcp_config.json:

mcp_config.json
{
  "mcpServers": {
    "nimbill": {
      "command": "npx",
      "args": [
        "-y",
        "nimbill-mcp"
      ],
      "env": {
        "NIMBILL_URL": "https://nimbill.mblob.me"
      }
    }
  }
}

Environment variables

Environment variables (all optional)

NIMBILL_URLDefault: https://nimbill.mblob.me
Base URL of the NimBill app your agent connects to.
NIMBILL_AGENT_SECRET_KEYDefault: Auto-generated
64-char hex Ed25519 private key. If omitted, a key is generated and saved at ~/.nimbill/agent-wallet.json.
NIMBILL_WALLET_FILEDefault: ~/.nimbill/agent-wallet.json
Custom path for the auto-generated agent wallet JSON file.
NIMBILL_WALLET_PASSPHRASEDefault: None (unencrypted)
Encrypts the wallet file and saved cheque secrets (scrypt + AES-256-GCM). Strongly recommended, especially on Windows.
NIMBILL_MAX_PAYMENT_NIMDefault: 100
Largest single payment, transfer or cheque the agent may send, in NIM.
NIMBILL_MAX_DAILY_NIMDefault: 500
Most NIM the agent may send in any 24 hours.
NIMIQ_RPC_URLDefault: https://rpc.nimiqwatch.com
Nimiq Mainnet Albatross JSON-RPC endpoint used for balances and broadcasts.