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.
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:
{
"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:
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:
{
"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:
{
"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.