Billium SDKs
Official client libraries for Billium — non-custodial crypto payments, invoices, and webhooks.
Packages
| Package | Version | Description |
|---|---|---|
@billium/node |  | Node.js SDK — invoices, webhook signature verification, webhook management |
@billium/mcp |  | MCP server — manage invoices and webhooks from Claude, Cursor, and any MCP host |
Additional language SDKs will live as siblings under packages/ as they ship.
Quick start
npm install @billium/node
import { Billium } from '@billium/node';
const billium = new Billium({
apiKey: process.env.BILLIUM_API_KEY,
merchantId: process.env.BILLIUM_MERCHANT_ID,
webhookSecret: process.env.BILLIUM_WEBHOOK_SECRET,
});
const invoice = await billium.invoices.create(
{ name: 'Order #1234', rawAmount: 99.99 },
{ idempotencyKey: crypto.randomUUID() },
);
See packages/node/README.md for the full Node.js SDK reference.
Repository layout
.
├── packages/
│ ├── node/ # @billium/node — TypeScript Node.js SDK
│ │ ├── src/ # Source
│ │ ├── tests/ # Vitest test suite
│ │ ├── README.md # Public-facing docs (rendered on npmjs.com)
│ │ └── CHANGELOG.md # Per-release notes
│ └── mcp/ # @billium/mcp — Model Context Protocol server
│ ├── src/ # Server + tool definitions
│ ├── tests/ # Vitest in-memory round-trip suite
│ └── README.md # Host setup (Claude Code, Cursor, …)
└── .github/
├── workflows/ # CI + release automation
├── ISSUE_TEMPLATE/ # Bug + feature request forms
└── CODEOWNERS # Review requirements
Development
This is an npm workspace. Run scripts from the repository root:
npm install # installs all workspace packages
npm run lint # typechecks every package (src + tests)
npm test # runs every package's test suite
npm run build # builds every package
To work on a specific package, you can also cd packages/node && npm <script>.
Releasing
Releases are published to npm by GitHub Actions when a v*.*.* tag is pushed:
- Bump
packages/node/package.json#versionandpackages/node/src/version.ts#SDK_VERSIONto the new version (CI verifies they match). - Add a section to
packages/node/CHANGELOG.mddescribing the changes. - Commit the bump on
main. - Tag and push:
git tag v1.0.1 && git push origin v1.0.1. - The release workflow runs lint, test, build, then
npm publishwith provenance.