Description

    

BoltzPay

> A fetch() that pays. x402, L402, MPP — auto-detected, multi-chain, open source.

BoltzPay detects payment protocols, negotiates the best chain, pays, and returns data. One call. No vendor lock-in.

Docs · Registry · npm · GitHub

import { BoltzPay } from "@boltzpay/sdk";
const agent = new BoltzPay({
  wallets: [
    { type: "coinbase", name: "main", coinbaseApiKeyId: "...", coinbaseApiKeySecret: "...", coinbaseWalletSecret: "..." },
  ],
  budget: { daily: "5.00" },
});
const response = await agent.fetch(url);
// x402, L402, MPP — protocol auto-detected, payment handled

Discover

Browse 6,900+ scored endpoints from the BoltzPay Registry:

const apis = await agent.discover({ protocol: "mpp", minScore: 80 });

Protocols

| Protocol | Payment | Wallet |
|———-|———|——–|
| x402 | USDC on-chain (Base, Solana) | Coinbase CDP |
| L402 | Bitcoin Lightning | NWC |
| MPP | Stripe, Tempo, Visa | Multi-wallet |

The SDK auto-detects which protocol an endpoint uses. Configure one or more wallets — the router tries each until one succeeds.

Sessions

MPP streaming sessions with deposit, pay-per-chunk, and clean close:

const session = await agent.openSession(url);
const res = await session.fetch(url);
const receipt = await session.close(); // { totalSpent, refunded, voucherCount }

MCP

Wrap any MCP client with automatic payment handling (-32042):

const wrapped = await agent.wrapMcpClient(mcpClient);
const result = await wrapped.callTool({ name: "paid-tool" });
// Budget enforced, receipt returned

Or give Claude Desktop a payment wallet — zero code:

{
  "mcpServers": {
    "boltzpay": {
      "command": "npx",
      "args": ["-y", "@boltzpay/mcp"]
    }
  }
}

Budget & Safety

agent.on("budget:exceeded", (e) => console.log(Blocked: ${e.period}));
agent.on("payment", (e) => console.log(${e.amount.toDisplayString()} via ${e.protocol}));
const budget = agent.getBudget();
// { dailySpent, monthlySpent, dailyLimit, monthlyLimit,
//   perTransactionLimit, dailyRemaining, monthlyRemaining }

Daily, monthly, per-transaction limits. Session deposit reservations. Allowlist/blocklist. Max amount guard.

CLI

npx @boltzpay/cli discover --protocol mpp --min-score 70
npx @boltzpay/cli fetch https://api.example.com
npx @boltzpay/cli diagnose https://api.example.com
npx @boltzpay/cli quote https://api.example.com

Packages

| Package | Description |
|———|————-|
| @boltzpay/sdk | SDK — fetch, discover, sessions, budget, events |
| @boltzpay/core | Domain types, Money VO, protocol interfaces |
| @boltzpay/protocols | Protocol adapters (x402, L402, MPP) |
| @boltzpay/mcp | MCP server — 7 tools for Claude Desktop |
| @boltzpay/cli | CLI — terminal + Python bridge |
| @boltzpay/ai-sdk | Vercel AI SDK tools |

Integrations

• LangChain: pip install langchain-boltzpay — docs
• CrewAI: pip install boltzpay-crewai — docs
• n8n: @boltzpay/n8n-nodes-boltzpay — docs
• OpenClaw: see integrations/openclaw/

Contributing

See CONTRIBUTING.md for setup instructions and PR guidelines.

License

MIT — see LICENSE

—

Created by @leventilo