Overview

ln.bot gives an AI agent or an app its own Bitcoin Lightning wallet, used from a CLI, an MCP server, a REST API or SDKs in five languages.

Updated View as Markdown

ln.bot runs the Lightning nodes and their channel liquidity. You create a wallet with one command or one API call, then receive and pay from it through whichever interface your code or your agent already uses. Balances are held on ln.bot's nodes, so treat a wallet as a hot balance for near-term spending, not as savings.

What you get

  • A wallet with a random Lightning address such as x4k7m2@ln.bot, which any Lightning wallet can pay. A vanity name costs ₿100 or more, once.
  • A user key (uk_) that reaches every wallet on the account, and wallet keys (wk_) that each reach one wallet.
  • The lnbot CLI, an MCP server for every wallet, the REST API, and SDKs for TypeScript, Python, Go, Rust and C#.
  • L402: charge for an HTTP API per request, or let an agent pay for one. Middleware exists for Express and ASP.NET Core.

Receiving is free, and so are transfers between ln.bot wallets, which settle in under a second. Paying out over Lightning costs 0.25%, at least ₿1, plus the network fee, which is another 0.25% and the routing fee; you can price a payment before sending it. Those payments usually settle in seconds and can fail. There is no subscription.

How agents use it

An agent with a wallet can:

  • get paid, by sharing its Lightning address or creating an invoice
  • pay a Lightning address, an LNURL or a BOLT11 invoice
  • pay for an API that answers with HTTP 402 and an L402 challenge
  • charge for its own endpoints with L402

Over MCP these are tools the agent calls itself. The tools have no spending limit of their own, so give an agent a wallet that holds only what it may spend.

Get started

curl -fsSL https://ln.bot/install.sh | bash
lnbot init
bash

lnbot init registers an account, creates its first wallet and prints the wallet's Lightning address, its API key and a recovery passphrase that is shown only once. For Windows, Homebrew or Go, see the install options. The Get API key button on ln.bot creates the same account and wallet in the browser.

  • Quick start: receive a first payment, check the balance, pay another wallet
  • CLI reference: every command, with its flags and its output
  • MCP server: connect Claude Code, Cursor or another MCP client
  • REST API: endpoints, keys, units and errors
  • SDKs: TypeScript, Python, Go, Rust and C#, and the L402 libraries