English Français العربية

Billium

Registre officiel Finance et paiements

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

Code source Site web Documentation

Installation

Ajoutez ceci à la configuration MCP de votre client (Claude Desktop : claude_desktop_config.json ; Cursor : .cursor/mcp.json ; VS Code et les autres utilisent la même forme « 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
Configuration 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>"
            }
        }
    }
}

Variables d'environnement

  • BILLIUM_API_KEY obligatoire secret Secret API key (sk_...), from the dashboard under Settings → Developer → API keys.
  • BILLIUM_MERCHANT_ID obligatoire Merchant ID (mer_...).
  • BILLIUM_BASE_URL Override the API base URL (testing / staging environments).

Documentation

Tirée du README du projet sur GitHub, actualisée chaque semaine. Les liens ouvrent GitHub.

Sommaire
  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

Questions fréquentes

Qu'est-ce que Billium ?

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

Comment installer Billium ?

Il s'exécute sur votre machine. Dans 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. Pour les autres clients, collez la configuration JSON de cette page dans leurs réglages MCP.

Faut-il une clé API pour Billium ?

Oui. Il attend BILLIUM_API_KEY, BILLIUM_MERCHANT_ID, à renseigner dans sa configuration.

Billium est-il open source ?

Oui. Son code est sur GitHub sous licence MIT.

Qui maintient Billium ?

Il est publié par BilliumHQ. AI.tn le référence sans le maintenir ni le recommander.

Issu du registre MCP officiel. Être listé n'est pas une recommandation : vérifiez le code et les permissions d'un serveur avant de lui donner accès à vos données.