MCP.Market

Billium MCP server

by BilliumHQ·io.github.BilliumHQ/billium·v0.1.3
No reviews yet

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

B71/100grade B
Write a reviewInstall
What users say
No reviews yet
Be the first
Safety scan
B71/100

full report

Adoption
New

0 stars27 downloads/wk

Reviews

Write one

Nobody has reviewed Billium yet.

If you have run it, two minutes of your experience saves the next person an afternoon.

Billium tools (23, 13 write)

write = sends, deletes, buys or posts

Read from the package source without running it. The installed server may list more.

  • cancel_invoicewrite action

    Cancel an invoice that has not yet been paid. Returns the updated invoice. Already-terminal invoices (paid/expired/cancelled) cannot be cancelled.

  • create_invoicewrite action

    Create a new crypto payment invoice for the merchant and return it, including the hosted checkout URL. The customer pays in crypto; settlement is non-custodial (funds go straight to the merchant wallet). An idempotency key is generated automatically unless you pass one.

  • create_productwrite action

    Create a product the merchant can sell through a hosted checkout page. Price is a fiat amount; the customer pays the crypto equivalent.

  • create_walletwrite action

    Add a receiving wallet for a (cryptocurrency, network) pair. Pass `address` for a DIRECT_WALLET, or `xpub` (extended PUBLIC key) for an XPUB_WALLET. One wallet per pair.

  • create_webhookwrite action

    Register a webhook endpoint that Billium will POST events to. Use 'invoice.*' or 'payment.*' to subscribe to every event in a category.

  • delete_productwrite action

    Delete a product.

  • delete_walletwrite action

    Delete a wallet. Rejected if it still has active payments against it.

  • delete_webhookwrite action

    Permanently delete a webhook endpoint.

  • get_customer

    Fetch a single customer by ID, including derived location when known.

  • get_customer_stats

    Get a customer\u2019s aggregate spend and invoice stats: total revenue from paid invoices, invoice counts, and paid rate.

  • get_invoice

    Fetch a single invoice by ID, including its current status, customer, payments, and status timeline.

  • get_product

    Fetch a single product by ID (with a presigned image URL).

  • get_wallet

    Fetch a single wallet configuration by ID.

  • list_customers

    List the merchant\u2019s customers (auto-created from invoices) with pagination and optional search by email/name/phone/address.

  • list_invoices

    List the merchant\u2019s invoices with pagination and optional search. Returns a page of invoices plus total/page metadata.

  • list_products

    List the merchant\u2019s products with pagination and optional search.

  • list_wallets

    List the merchant\u2019s crypto wallet configurations (DIRECT_WALLET / XPUB_WALLET). Only public config is returned \u2014 never private keys.

  • list_webhooks

    List all webhook endpoints configured for the merchant.

  • ping_webhookwrite action

    Send a test event to a webhook endpoint to verify it is reachable and that your signature verification works.

  • update_customerwrite action

    Update a customer\u2019s name, address, or phone number. Email cannot be changed (it is the key that ties a customer to their invoices).

  • update_productwrite action

    Update a product. Only the fields you pass are changed.

  • update_walletwrite action

    Update a wallet\u2019s mutable config (address, xpub, enabled state, confirmations, derivation path). Identity fields cannot change.

  • update_webhookwrite action

    Update an existing webhook endpoint (URL, subscribed events, active state, retries, or timeout). Only the fields you pass are changed.

Public scan report

scanner v0.1.9 · 2026-09-26 · same rubric, same numbers if you re-run it

no findings
  • Code scan2 source files scanned25/25
  • –Live reliabilityno gateway calls yet and no remote to proben/a
  • –Tool poisoningtools not inspected (local package is not executed); not countedn/a
  • Auth qualitystatic API keys via environment variables6/15
  • Maintenancelast push 97 days ago8/15
  • Maintainer identityregistry namespace matches repository owner7/10
Overall 71/100. Components that don't apply are left out of the denominator. Any critical finding is an F.RubricAppeal a findingJSON

How Billium compares

Against every graded Finance MCP server, from our own scans and uptime checks. Updated after each scan run.

Safety score
71/100
higher than 42% of 1,761 Finance servers
Tools
23
the typical Finance server has 8
Tools that change things
57%
typical: 0%. Fewer write tools means less an agent can break
Downloads a week
27
more than 15% of 421 Finance servers with a package

What its tools let an agent do: 10 read · 4 create · 5 change · 4 delete

Install Billium in Claude Code, Cursor or VS Code

Runs npx -y @billium/mcp on your machine. Read the scan report first; the gateway never runs local packages.

claude mcp add billium -- npx -y @billium/mcp
Add to Cursor

What the publisher says

From the Billium repository's README, as published. We do not edit it. Read it on GitHub

Billium SDKs

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

Packages

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 .

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

Nothing above is checked by us. What we check is on the safety report.

Billium: common questions

Is Billium MCP server safe?
Mostly: it is graded B (71/100). Read the Billium safety report
How do I install Billium?
It runs on your machine. Copy the Claude Code, Cursor, VS Code or Claude Desktop config from the install section.
Does Billium need an API key?
Yes. The registry entry asks for BILLIUM_API_KEY.
Is Billium maintained?
The last commit was 135 days ago (2026-06-22). The latest release is v0.1.3.
What can I use instead of Billium?
Servers from other publishers that do the same job: Yolfi Payments MCP server, Quickbooks MCP server and PayRam MCP server.
How does Billium compare with other Finance MCP servers?
safety score 71/100 (higher than 42% of 1,761 Finance servers); tools 23 (the typical Finance server has 8); tools that change things 57% (typical: 0%. Fewer write tools means less an agent can break). Full comparison.

Alternatives to Billium

Same job from other publishers: the closest match first, then the best rated.

  • Yolfi Payments MCP
    Let AI agents add Yolfi crypto checkout, paylinks, webhooks, and status checks.
    A
  • Quickbooks
    MCP server for QuickBooks Online (Intuit) — customers, invoices, payments, items, accounts, P&L
    More from codespar →
    B
  • PayRam
    Install, configure, operate and integrate self-hosted PayRam crypto payment gateways.
    B
  • Xero
    Xero MCP server for invoices, contacts, payments, quotes, and financial reports.
    A
  • Blockrun
    Web search, deep research, prediction markets & crypto data for AI agents. Pay per call via x402.
    B