Billium SDKs
Official client libraries for Billium — non-custodial crypto payments, invoices, and webhooks.
接入你的智能体
發布者自己的指令。不是 PlugMCP 端點。
用我們的金鑰與日誌託管一份副本。
npx -y @billium/[email protected]Claude Code 沒有本機指令的安裝連結。複製下方指令並在終端機中執行。
BILLIUM_API_KEY=<secret> BILLIUM_MERCHANT_ID=<value> BILLIUM_BASE_URL=<value> claude mcp add io.github.billiumhq-billium -- npx -y @billium/mcp@0.1.3在終端機中執行。
{ "mcpServers": { "io.github.billiumhq-billium": { "command": "npx", "args": [ "-y", "@billium/[email protected]" ], "env": { "BILLIUM_API_KEY": "<secret>", "BILLIUM_MERCHANT_ID": "<value>", "BILLIUM_BASE_URL": "<value>" } } }}claude_desktop_config.json
遠端 URL 還是本機指令? 兩種安裝方式的差異
來自發布者
Official client libraries for Billium — non-custodial crypto payments, invoices, and webhooks.
Official Billium MCP server: manage crypto invoices, payments, and webhooks from any MCP host.
| 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.
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.
.
├── 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
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>.
Releases are published to npm by GitHub Actions when a v*.*.* tag is pushed:
packages/node/package.json#version and packages/node/src/version.ts#SDK_VERSION to the new version (CI verifies they match).packages/node/CHANGELOG.md describing the changes.main.git tag v1.0.1 && git push origin v1.0.1.npm publish with provenance.Official Billium MCP server: manage crypto invoices, payments, and webhooks from any MCP host.
{ "mcpServers": { "io.github.billiumhq-billium": { "command": "npx", "args": [ "-y", "@billium/[email protected]" ], "env": { "BILLIUM_API_KEY": "<secret>", "BILLIUM_MERCHANT_ID": "<value>", "BILLIUM_BASE_URL": "<value>" } } }}工具
尚無工具清單。遠端伺服器會在首次健康檢查後取得工具清單。
常見問題
在本頁複製適用於 Cursor、Claude Desktop、Claude Code 或 VS Code 的 stdio 設定。它使用發布者的安裝方式,而不是 PlugMCP 代理伺服器。
發布者列出了以下環境變數:BILLIUM_API_KEY, BILLIUM_MERCHANT_ID, BILLIUM_BASE_URL。
Billium 透過 stdio 在本機執行。
上次檢查時間:2026-11-08。 Official Billium MCP server: manage crypto invoices, payments, and webhooks from any MCP host.