English Français العربية

Billium

السجل الرسمي المالية والمدفوعات

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

الشيفرة المصدرية الموقع التوثيق

التثبيت

أضف هذا إلى إعدادات MCP في عميلك (Claude Desktop: claude_desktop_config.json، وCursor: ‏.cursor/mcp.json، ويستخدم VS Code وغيره الصيغة نفسها «mcpServers»).

NPM package @billium/mcp
Claude Code 
claude mcp add billium -e 'BILLIUM_API_KEY=<your billium_api_key>' -e 'BILLIUM_MERCHANT_ID=<BILLIUM_MERCHANT_ID>' -e 'BILLIUM_BASE_URL=<BILLIUM_BASE_URL>' -- npx -y @billium/mcp@0.1.3
إعداد JSON (Claude Desktop وCursor وVS Code) 
{
    "mcpServers": {
        "billium": {
            "command": "npx",
            "args": [
                "-y",
                "@billium/mcp@0.1.3"
            ],
            "env": {
                "BILLIUM_API_KEY": "<your billium_api_key>",
                "BILLIUM_MERCHANT_ID": "<BILLIUM_MERCHANT_ID>",
                "BILLIUM_BASE_URL": "<BILLIUM_BASE_URL>"
            }
        }
    }
}

متغيرات البيئة

  • BILLIUM_API_KEY إلزامي سري Secret API key (sk_...), from the dashboard under Settings → Developer → API keys.
  • BILLIUM_MERCHANT_ID إلزامي Merchant ID (mer_...).
  • BILLIUM_BASE_URL Override the API base URL (testing / staging environments).

التوثيق

مأخوذ من ملف README للمشروع على GitHub ويُحدَّث أسبوعيًا. تفتح الروابط على GitHub.

المحتويات
  1. Billium SDKs
  2. Packages
  3. Quick start
  4. Repository layout
  5. Development
  6. License

Billium SDKs

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

Packages

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

الأسئلة الشائعة

ما هو Billium؟

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

كيف أثبّت Billium؟

يعمل على جهازك. في Claude Code: claude mcp add billium -e 'BILLIUM_API_KEY=<your billium_api_key>' -e 'BILLIUM_MERCHANT_ID=<BILLIUM_MERCHANT_ID>' -e 'BILLIUM_BASE_URL=<BILLIUM_BASE_URL>' -- npx -y @billium/mcp@0.1.3. وفي العملاء الآخرين، الصق إعداد JSON من هذه الصفحة في إعدادات MCP الخاصة بهم.

هل يحتاج Billium إلى مفتاح API؟

نعم. يتطلب BILLIUM_API_KEY, BILLIUM_MERCHANT_ID، وتضبطها في إعداداته.

هل Billium مفتوح المصدر؟

نعم. شيفرته متاحة على GitHub بترخيص MIT.

من يصون Billium؟

ينشره BilliumHQ. يدرجه AI.tn لكنه لا يصونه ولا يوصي به.

من سجل MCP الرسمي. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.