Back to Browse

Billium Node MCP Server

Developer ToolsLow Risk9.7MCP RegistryLocal
Free

Server data from the Official MCP Registry

Official Billium MCP server: manage crypto invoices, payments, and webhooks from any MCP host.

About

Official Billium MCP server: manage crypto invoices, payments, and webhooks from any MCP host.

Security Report

9.7
Low Risk9.7Low Risk

Valid MCP server (2 strong, 1 medium validity signals). No known CVEs in dependencies. ⚠️ Package registry links to a different repository than scanned source. Imported from the Official MCP Registry. 1 finding(s) downgraded by scanner intelligence.

9 files analyzed · 1 issue found

Security scores are indicators to help you make informed decisions, not guarantees. Always review permissions before connecting any MCP server.

What You'll Need

Set these up before or after installing:

Secret API key (sk_...), from the dashboard under Settings → Developer → API keys.Required

Environment variable: BILLIUM_API_KEY

Merchant ID (mer_...).Optional

Environment variable: BILLIUM_MERCHANT_ID

Override the API base URL (testing / staging environments).Optional

Environment variable: BILLIUM_BASE_URL

How to Install

Add this to your MCP configuration file:

{
  "mcpServers": {
    "io-github-billiumhq-billium": {
      "env": {
        "BILLIUM_API_KEY": "your-billium-api-key-here",
        "BILLIUM_BASE_URL": "your-billium-base-url-here",
        "BILLIUM_MERCHANT_ID": "your-billium-merchant-id-here"
      },
      "args": [
        "-y",
        "@billium/mcp"
      ],
      "command": "npx"
    }
  }
}

Documentation

View on GitHub

From the project's GitHub README.

Billium SDKs

Official client libraries for Billium — non-custodial crypto payments, invoices, and webhooks.

Packages

PackageVersionDescription
@billium/nodenpmNode.js SDK — invoices, webhook signature verification, webhook management
@billium/mcpnpmMCP 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:

  1. Bump packages/node/package.json#version and packages/node/src/version.ts#SDK_VERSION to the new version (CI verifies they match).
  2. Add a section to packages/node/CHANGELOG.md describing the changes.
  3. Commit the bump on main.
  4. Tag and push: git tag v1.0.1 && git push origin v1.0.1.
  5. The release workflow runs lint, test, build, then npm publish with provenance.

License

MIT

Reviews

No reviews yet

Be the first to review this server!