NimBillDocs

Get started

Give your AI agent its own Nimiq wallet.

15 ToolsNon-Custodial Agent WalletModel Context Protocol (MCP)

NimBill ships an MCP server on npm (npx -y nimbill-mcp) that gives Claude, Cursor, Windsurf, and Antigravity their own non-custodial Ed25519 Nimiq wallet, a @tag, and 15 tools to pay invoices, buy from boards, send NIM by tag, and write or cash cheques on-chain.

Run it with npx

npmnimbill-mcpv1.1.0
Node 18.17+ · no install needed
npx -y nimbill-mcp

Compatible hosts

Compatible MCP hosts & AI assistants

  • ChatGPT
  • Claude
  • Cursor
  • Grok
  • Gemini
  • Perplexity

What it does

An AI agent that can earn, spend, and hold NIM. Most payment APIs stop at creating a link for a human to click. NimBill's MCP server gives your agent its own Nimiq keypair on your machine so it can complete the entire loop on-chain.

Own Non-Custodial Nimiq Wallet

On first launch, the MCP server generates an Ed25519 keypair at ~/.nimbill/agent-wallet.json, derives its NQ… address, and signs NimBill's challenge message to log into its own account. Your agent's private key never leaves your computer.

Pay Invoices & Boards On-Chain

The agent can read any /pay/<tag> board or NMN-… invoice, lock a 5-minute NIM quote, sign the Nimiq Albatross transaction with the NimBill <id> memo, broadcast it, and verify the receipt.

Write & Cash Cheques

Hand your agent a CHQ-… code in chat and it can cash the NIM straight into its wallet (or route it to any @tag) — or ask your agent to write a funded cheque and hand you the link.

Claim a @tag & Bill Clients

Your agent can claim its own handle like studiobot@nimbill, issue invoices in 19 currencies, and check when clients have paid on the blockchain.

Example prompts

What you can ask your AI once connected. Try any of these prompts in Claude, Cursor, or Antigravity after adding the MCP server.

Check wallet & claim a tag

“Check your NimBill wallet status, then set your profile name to 'Studio Bot' and claim the tag studiobot@nimbill.”

Cash a cheque to fund the agent

“Cash this NimBill cheque into your wallet: CHQ-HS8DU-FWZ47-EA6CRP-YMWJMG-R7PZGA-K2MJND”

Buy from someone's public board

“Look up ada@nimbill's board, show me what she sells, and buy 1 Logo pack for Tunde.”

Send NIM to a tag

“Send $5 worth of NIM to chidi@nimbill with the note 'Coffee on me'.”

Write a cheque for a teammate or user

“Write a 50 NIM cheque locked to tunde@nimbill for 'Bug bounty' and give me the link and cheque code.”

Bill a client

“Create an invoice for 'Kemi Labs' for 45,000 NGN for 'Landing page copy' and give me the invoice link.”