Billium
Official Billium MCP server: manage crypto invoices, payments, and webhooks from any MCP host.
Runs on your machine from its package; the steps are below.
What it does
- Reads
- Writes
- High impact
At most: moves money, runs code or commands, deletes data, or sends messages for you.
What it costs
FreeOdel charges nothing per call. The publisher may charge for its own service.
Runs locally over stdio
This server isn't hosted — your MCP client launches it from a package registry. Use one of the commands below, or drop the config into your client (e.g. Claude Desktop).
Run
npx -y @billium/mcp
MCP client config
{
"mcpServers": {
"billium": {
"command": "npx",
"args": [
"-y",
"@billium/mcp"
]
}
}
}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.
