Payments / MCP

Lightning rails for software.

Create invoices, inspect a wallet, and pay BOLT11 requests through a focused MCP toolset. Each bearer token is scoped to one bound wallet key.

One endpoint. Seven guarded tools.

The gateway speaks MCP over HTTP. SendAuthorization: Bearer <token>on every request. Unauthenticated requests return401 Unauthorized.

  • Walletget_balance

    Current wallet balance in satoshis and wallet metadata.

  • Walletlist_transactions

    Paginated transaction history for the bound wallet key.

  • Paymentscreate_invoice

    Create a pay-on-demand invoice to receive funds. Returns the BOLT11 payment request.

  • Paymentsget_invoice

    Fetch an invoice by payment hash and report its paid status.

  • Paymentsdecode_invoice

    Decode a BOLT11 invoice without paying it.

  • Paymentspay_invoice

    Pay a BOLT11 invoice from the wallet. Requires the wallet to have funds.

  • Nodeget_node_info

    Node info for the connected Lightning backend.

Data API

Public catalogue endpoints need no authentication and are served with a short cache header.

  • GET/api/catalogueThe ranked symbol catalogue and its versioned sync manifest, cached for one hour.
  • GET/sitemap.xmlOne canonical /chart/{ticker} URL per listed symbol, cached for one hour.

Get started

The chart, markets, and forge remain fully open in the browser — no account or token required. Payment tokens are available to operator-approved integrations.