Billium MCP Server

by billiumhqio.github.BilliumHQ/billiumv0.1.3

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

0Node.jsstdioofficial registry

context tax

queued

security

queued

cold start

queued

freshness

Slowing4mo ago

Install Billium MCP server

claude mcp add billium -e BILLIUM_API_KEY='<billium-api-key>' -e BILLIUM_MERCHANT_ID='<billium-merchant-id>' -- npx -y @billium/mcp

{
  "mcpServers": {
    "billium": {
      "command": "npx",
      "args": [
        "-y",
        "@billium/mcp"
      ],
      "env": {
        "BILLIUM_API_KEY": "<billium-api-key>",
        "BILLIUM_MERCHANT_ID": "<billium-merchant-id>"
      }
    }
  }
}

Add to ~/.cursor/mcp.json (global) or .cursor/mcp.json (project).

{
  "mcpServers": {
    "billium": {
      "command": "npx",
      "args": [
        "-y",
        "@billium/mcp"
      ],
      "env": {
        "BILLIUM_API_KEY": "<billium-api-key>",
        "BILLIUM_MERCHANT_ID": "<billium-merchant-id>"
      }
    }
  }
}

Settings → Developer → Edit Config (claude_desktop_config.json), then restart.

{
  "servers": {
    "billium": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@billium/mcp"
      ],
      "env": {
        "BILLIUM_API_KEY": "<billium-api-key>",
        "BILLIUM_MERCHANT_ID": "<billium-merchant-id>"
      }
    }
  }
}

Add to .vscode/mcp.json in your workspace.

{
  "mcpServers": {
    "billium": {
      "command": "npx",
      "args": [
        "-y",
        "@billium/mcp"
      ],
      "env": {
        "BILLIUM_API_KEY": "<billium-api-key>",
        "BILLIUM_MERCHANT_ID": "<billium-merchant-id>"
      }
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json.

Configuration

Variable	Required	Secret	Description
BILLIUM_API_KEY	yes	yes	Secret API key (sk_...), from the dashboard under Settings → Developer → API keys.
BILLIUM_MERCHANT_ID	yes	—	Merchant ID (mer_...).
BILLIUM_BASE_URL	—	—	Override the API base URL (testing / staging environments).

Freshness

Slowing — last maintenance signal 4mo ago. The newest of the signals below sets the band.

Last commit (default branch)
2026-06-22 · 4mo ago · GitHub
Latest release
2026-06-22 · 4mo ago · GitHub · mcp-v0.1.3
Package published
no data · npm/PyPI
Registry entry updated
2026-06-22 · 4mo ago · official registry · v0.1.3

FAQ

›How do I install the Billium MCP server in Claude Code?

Run: claude mcp add billium -e BILLIUM_API_KEY='<billium-api-key>' -e BILLIUM_MERCHANT_ID='<billium-merchant-id>' -- npx -y @billium/mcp. For Cursor, VS Code, Claude Desktop and Windsurf, use the install tabs above.

›Does Billium require an API key?

Yes. It expects BILLIUM_API_KEY, BILLIUM_MERCHANT_ID, of which 1 is a secret.

›Can I use Billium as a remote (hosted) MCP server?

No hosted endpoint is published; it runs locally over stdio.

›Is Billium in the official MCP registry?

Yes, as io.github.BilliumHQ/billium.