{"mcp_version":"2025-11-25","serverInfo":{"name":"ln.bot","version":"1.0.0","description":"Bitcoin Lightning wallet for AI agents — pay, receive, and manage sats over Lightning Network","homepage":"https://ln.bot"},"transport":{"type":"streamable-http","url":"https://api.ln.bot/v1/wallets/{walletId}/mcp"},"capabilities":{"tools":true,"logging":true},"endpoints":[{"url":"https://api.ln.bot/v1/wallets/{walletId}/mcp","transport":"streamable-http","capabilities":["tools","logging"],"auth":{"type":"bearer"}}],"tools":[{"name":"get_wallet","description":"Get wallet balance and summary. Returns balance, on-hold amount, available balance, and invoice/payment/transaction counts."},{"name":"create_invoice","description":"Create a Lightning invoice to receive sats. Returns the invoice number, bolt11 string, amount, and expiry."},{"name":"quote_payment","description":"Price a payment without sending it: the network fee estimate, the service fee and the total for a Lightning address, LNURL, or BOLT11 invoice. Omit amount for a Lightning address or LNURL to get the most the wallet can send there. Read-only."},{"name":"send_payment","description":"Send sats to a Lightning address (user@domain), LNURL, or BOLT11 invoice. This sends real money: the amount and the fees are placed on hold until settlement. maxFee caps the network fee and defaults to 1% of the amount, minimum 20 sats."},{"name":"list_invoices","description":"List invoices (newest first). Returns paginated invoice summaries with status, amount, and bolt11."},{"name":"list_payments","description":"List payments (newest first). Returns paginated payment summaries with status, amount, and destination."},{"name":"list_transactions","description":"List transactions (newest first). Returns paginated transaction history with type, amount, and balance after."},{"name":"list_addresses","description":"List the wallet's Lightning addresses (user@domain format)."},{"name":"buy_address","description":"Buy a vanity Lightning address (name@ln.bot). Costs sats based on length: 3 chars = 10,000 sats, 4 chars = 1,000 sats, 5+ chars = 100 sats."},{"name":"create_l402_challenge","description":"Create an L402 challenge (invoice + macaroon) for pay-per-use API access. Returns the macaroon, invoice, and pre-formatted WWW-Authenticate header value."},{"name":"pay_l402_challenge","description":"Pay an L402 challenge and get a ready-to-use Authorization header. Parses the WWW-Authenticate header, pays the invoice, and waits for settlement."},{"name":"verify_l402_token","description":"Verify an L402 authorization token. Checks macaroon signature, preimage proof-of-payment, and caveat validity."}]}