@billium/mcp 0.1.0

package/CHANGELOG.md

@@ -0,0 +1,19 @@
+# Changelog
+
+All notable changes to `@billium/mcp` are documented here. The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/), and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [0.1.0]
+
+Initial public release of the Billium MCP server.
+
+### Added
+
+- **stdio MCP server** exposing the Billium API to any [Model Context Protocol](https://modelcontextprotocol.io) host — Claude Code, Claude Desktop, Cursor, and others. Run with `npx -y @billium/mcp` (bin: `billium-mcp`).
+- **23 tools** across five resources: invoices (`create_invoice`, `get_invoice`, `list_invoices`, `cancel_invoice`), webhooks (`create_webhook`, `list_webhooks`, `update_webhook`, `delete_webhook`, `ping_webhook`), customers (`list_customers`, `get_customer`, `get_customer_stats`, `update_customer`), products (`create_product`, `get_product`, `list_products`, `update_product`, `delete_product`), and wallets (`list_wallets`, `get_wallet`, `create_wallet`, `update_wallet`, `delete_wallet`).
+- **Environment-based configuration.** Reads `BILLIUM_API_KEY` (`sk_...`) and `BILLIUM_MERCHANT_ID` (`mer_...`), with an optional `BILLIUM_BASE_URL` override for self-hosted or testing backends.
+- **Zod-validated tool inputs.** Each tool validates its arguments before forwarding to the SDK, so malformed agent calls fail fast with a clear error rather than a generic API rejection.
+- **Thin wrapper over [`@billium/node`](https://www.npmjs.com/package/@billium/node).** The server adds no custodial layer — your secret key stays on your machine and talks directly to the Billium API over HTTPS.
+- **Automatic idempotency.** `create_invoice` always sends an idempotency key (generated if you don't pass one), so a retried tool call never creates a duplicate invoice.
+- **npm provenance.** Published from GitHub Actions via OIDC Trusted Publishing, so every release carries a verifiable attestation tying the tarball to its source commit. Verify with `npm audit signatures @billium/mcp`.
+
+[0.1.0]: https://github.com/BilliumHQ/billium-node/releases/tag/mcp-v0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Billium
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,126 @@
+# @billium/mcp
+
+The official **Billium MCP server** — manage non-custodial crypto invoices and webhooks from any [Model Context Protocol](https://modelcontextprotocol.io) host: Claude Code, Claude Desktop, Cursor, and others.
+
+Once connected, you can just ask:
+
+> _"Create a $49.99 invoice for order #1234 and give me the checkout link."_
+> _"List my last 10 invoices and tell me which are still awaiting payment."_
+> _"Add a webhook to https://api.myshop.com/billium that fires on invoice.paid."_
+
+…and the agent calls Billium directly.
+
+## Requirements
+
+- Node.js ≥ 18
+- A Billium **secret** API key (`sk_...`) and your **merchant ID** (`mer_...`), from the dashboard under **Settings → Developer → API keys**.
+
+## Configuration
+
+The server reads three environment variables:
+
+| Variable | Required | Description |
+| --- | --- | --- |
+| `BILLIUM_API_KEY` | ✅ | Secret API key (`sk_...`) |
+| `BILLIUM_MERCHANT_ID` | ✅ | Merchant ID (`mer_...`) |
+| `BILLIUM_BASE_URL` | — | Override the API base URL (self-hosted / testing) |
+
+### Claude Code
+
+```bash
+claude mcp add billium \
+  --env BILLIUM_API_KEY=sk_your_key \
+  --env BILLIUM_MERCHANT_ID=mer_your_id \
+  -- npx -y @billium/mcp
+```
+
+### Claude Desktop / Cursor
+
+Add to your MCP config (`claude_desktop_config.json`, or Cursor's `mcp.json`):
+
+```json
+{
+  "mcpServers": {
+    "billium": {
+      "command": "npx",
+      "args": ["-y", "@billium/mcp"],
+      "env": {
+        "BILLIUM_API_KEY": "sk_your_key",
+        "BILLIUM_MERCHANT_ID": "mer_your_id"
+      }
+    }
+  }
+}
+```
+
+## Tools
+
+23 tools across invoices, webhooks, customers, products, and wallets.
+
+**Invoices**
+
+| Tool | Description |
+| --- | --- |
+| `create_invoice` | Create a crypto payment invoice (auto idempotency key) |
+| `get_invoice` | Fetch an invoice by ID with status, payments, and timeline |
+| `list_invoices` | List invoices with pagination and search |
+| `cancel_invoice` | Cancel an unpaid invoice |
+
+**Webhooks**
+
+| Tool | Description |
+| --- | --- |
+| `create_webhook` | Register a webhook endpoint for invoice/payment events |
+| `list_webhooks` | List configured webhook endpoints |
+| `update_webhook` | Update a webhook's URL, events, or settings |
+| `delete_webhook` | Delete a webhook endpoint |
+| `ping_webhook` | Send a test event to a webhook endpoint |
+
+**Customers**
+
+| Tool | Description |
+| --- | --- |
+| `list_customers` | List customers with pagination and search |
+| `get_customer` | Fetch a customer by ID |
+| `get_customer_stats` | Revenue and invoice stats for a customer |
+| `update_customer` | Update a customer's name/address/phone |
+
+**Products**
+
+| Tool | Description |
+| --- | --- |
+| `create_product` | Create a product for hosted checkout |
+| `get_product` | Fetch a product by ID |
+| `list_products` | List products with pagination and search |
+| `update_product` | Update a product |
+| `delete_product` | Delete a product |
+
+**Wallets**
+
+| Tool | Description |
+| --- | --- |
+| `list_wallets` | List wallet configurations (public config only) |
+| `get_wallet` | Fetch a wallet by ID |
+| `create_wallet` | Add a DIRECT_WALLET (address) or XPUB_WALLET (xpub) |
+| `update_wallet` | Update a wallet's config |
+| `delete_wallet` | Delete a wallet |
+
+## Security
+
+- Your secret key never leaves your machine — the server runs locally and talks
+  directly to the Billium API over HTTPS.
+- Settlement is **non-custodial**: payments go straight to your wallet; Billium
+  never holds funds.
+- `create_invoice` always sends an idempotency key (generated if you don't pass
+  one), so a retried call never creates a duplicate invoice.
+
+## How it works
+
+This server is a thin [MCP](https://modelcontextprotocol.io) wrapper over the
+[`@billium/node`](https://www.npmjs.com/package/@billium/node) SDK, exposed over
+stdio. Each tool validates its input with [zod](https://zod.dev) and forwards it
+to the SDK.
+
+## License
+
+MIT

package/dist/index.js

@@ -0,0 +1,552 @@
+#!/usr/bin/env node
+
+// src/index.ts
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+
+// src/config.ts
+import { Billium } from "@billium/node";
+function billiumFromEnv(env = process.env) {
+  const apiKey = env.BILLIUM_API_KEY?.trim();
+  const merchantId = env.BILLIUM_MERCHANT_ID?.trim();
+  const missing = [];
+  if (!apiKey) missing.push("BILLIUM_API_KEY");
+  if (!merchantId) missing.push("BILLIUM_MERCHANT_ID");
+  if (missing.length > 0) {
+    throw new Error(
+      `Missing required environment variable(s): ${missing.join(", ")}. Generate a secret API key in the Billium dashboard under Settings \u2192 Developer \u2192 API keys.`
+    );
+  }
+  return new Billium({
+    apiKey,
+    merchantId,
+    baseUrl: env.BILLIUM_BASE_URL?.trim() || void 0
+  });
+}
+
+// src/server.ts
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+
+// src/tools.ts
+import { randomUUID } from "crypto";
+import { z } from "zod";
+var WEBHOOK_EVENTS = [
+  "invoice.*",
+  "invoice.created",
+  "invoice.updated",
+  "invoice.paid",
+  "invoice.underpaid",
+  "invoice.overpaid",
+  "invoice.expired",
+  "invoice.cancelled",
+  "payment.*",
+  "payment.created",
+  "payment.updated",
+  "payment.detected",
+  "payment.confirmed",
+  "payment.paid",
+  "payment.underpaid",
+  "payment.overpaid",
+  "payment.expired"
+];
+function ok(data) {
+  const text = typeof data === "string" ? data : JSON.stringify(data, null, 2);
+  return { content: [{ type: "text", text }] };
+}
+function fail(err) {
+  const status = err?.status;
+  const message = err instanceof Error ? err.message : String(err);
+  const text = status ? `Billium API error (${status}): ${message}` : `Billium error: ${message}`;
+  return { content: [{ type: "text", text }], isError: true };
+}
+function registerTools(server, billium) {
+  server.registerTool(
+    "create_invoice",
+    {
+      title: "Create invoice",
+      description: "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.",
+      inputSchema: {
+        name: z.string().describe('Invoice display name, e.g. "Order #1234".'),
+        rawAmount: z.number().positive().describe("Amount in the given currency (e.g. 99.99)."),
+        currency: z.string().optional().describe("Currency code, e.g. 'USD'. Defaults to USD."),
+        customerEmail: z.string().email().optional(),
+        customerName: z.string().optional(),
+        customerAddress: z.string().optional(),
+        customerPhoneNumber: z.string().optional(),
+        description: z.string().optional(),
+        redirectUrl: z.string().url().optional().describe("URL to send the customer to after a successful payment."),
+        idempotencyKey: z.string().optional().describe(
+          "Optional dedup key. If omitted, a UUID is generated so retries never create duplicate invoices."
+        )
+      }
+    },
+    async ({ idempotencyKey, ...params }) => {
+      try {
+        const invoice = await billium.invoices.create(params, {
+          idempotencyKey: idempotencyKey ?? randomUUID()
+        });
+        return ok(invoice);
+      } catch (err) {
+        return fail(err);
+      }
+    }
+  );
+  server.registerTool(
+    "get_invoice",
+    {
+      title: "Get invoice",
+      description: "Fetch a single invoice by ID, including its current status, customer, payments, and status timeline.",
+      inputSchema: {
+        invoiceId: z.string().describe("The invoice ID (inv_...).")
+      }
+    },
+    async ({ invoiceId }) => {
+      try {
+        return ok(await billium.invoices.get(invoiceId));
+      } catch (err) {
+        return fail(err);
+      }
+    }
+  );
+  server.registerTool(
+    "list_invoices",
+    {
+      title: "List invoices",
+      description: "List the merchant\u2019s invoices with pagination and optional search. Returns a page of invoices plus total/page metadata.",
+      inputSchema: {
+        page: z.number().int().positive().optional(),
+        limit: z.number().int().positive().max(100).optional().describe("Results per page (max 100). Defaults to 10."),
+        search: z.string().optional().describe("Filter by invoice name, description, or ID.")
+      }
+    },
+    async (params) => {
+      try {
+        return ok(await billium.invoices.list(params));
+      } catch (err) {
+        return fail(err);
+      }
+    }
+  );
+  server.registerTool(
+    "cancel_invoice",
+    {
+      title: "Cancel invoice",
+      description: "Cancel an invoice that has not yet been paid. Returns the updated invoice. Already-terminal invoices (paid/expired/cancelled) cannot be cancelled.",
+      inputSchema: {
+        invoiceId: z.string().describe("The invoice ID (inv_...).")
+      }
+    },
+    async ({ invoiceId }) => {
+      try {
+        return ok(await billium.invoices.cancel(invoiceId));
+      } catch (err) {
+        return fail(err);
+      }
+    }
+  );
+  server.registerTool(
+    "create_webhook",
+    {
+      title: "Create webhook",
+      description: "Register a webhook endpoint that Billium will POST events to. Use 'invoice.*' or 'payment.*' to subscribe to every event in a category.",
+      inputSchema: {
+        url: z.string().url().describe("HTTPS URL Billium will POST events to."),
+        events: z.array(z.enum(WEBHOOK_EVENTS)).nonempty().describe("Event types to subscribe to."),
+        description: z.string().optional(),
+        isActive: z.boolean().optional(),
+        retryCount: z.number().int().min(0).max(10).optional(),
+        timeout: z.number().int().min(1e3).max(3e4).optional()
+      }
+    },
+    async (params) => {
+      try {
+        return ok(await billium.webhooks.create(params));
+      } catch (err) {
+        return fail(err);
+      }
+    }
+  );
+  server.registerTool(
+    "list_webhooks",
+    {
+      title: "List webhooks",
+      description: "List all webhook endpoints configured for the merchant.",
+      inputSchema: {}
+    },
+    async () => {
+      try {
+        return ok(await billium.webhooks.list());
+      } catch (err) {
+        return fail(err);
+      }
+    }
+  );
+  server.registerTool(
+    "update_webhook",
+    {
+      title: "Update webhook",
+      description: "Update an existing webhook endpoint (URL, subscribed events, active state, retries, or timeout). Only the fields you pass are changed.",
+      inputSchema: {
+        webhookId: z.string().describe("The webhook ID (wh_...)."),
+        url: z.string().url().optional(),
+        events: z.array(z.enum(WEBHOOK_EVENTS)).nonempty().optional(),
+        description: z.string().optional(),
+        isActive: z.boolean().optional(),
+        retryCount: z.number().int().min(0).max(10).optional(),
+        timeout: z.number().int().min(1e3).max(3e4).optional()
+      }
+    },
+    async ({ webhookId, ...params }) => {
+      try {
+        return ok(await billium.webhooks.update(webhookId, params));
+      } catch (err) {
+        return fail(err);
+      }
+    }
+  );
+  server.registerTool(
+    "delete_webhook",
+    {
+      title: "Delete webhook",
+      description: "Permanently delete a webhook endpoint.",
+      inputSchema: {
+        webhookId: z.string().describe("The webhook ID (wh_...).")
+      }
+    },
+    async ({ webhookId }) => {
+      try {
+        await billium.webhooks.delete(webhookId);
+        return ok(`Webhook ${webhookId} deleted.`);
+      } catch (err) {
+        return fail(err);
+      }
+    }
+  );
+  server.registerTool(
+    "ping_webhook",
+    {
+      title: "Ping webhook",
+      description: "Send a test event to a webhook endpoint to verify it is reachable and that your signature verification works.",
+      inputSchema: {
+        webhookId: z.string().describe("The webhook ID (wh_...).")
+      }
+    },
+    async ({ webhookId }) => {
+      try {
+        await billium.webhooks.ping(webhookId);
+        return ok(`Ping sent to webhook ${webhookId}.`);
+      } catch (err) {
+        return fail(err);
+      }
+    }
+  );
+}
+
+// src/tools-merchant.ts
+import { z as z2 } from "zod";
+var CRYPTOCURRENCIES = [
+  "BTC",
+  "ETH",
+  "USDT",
+  "USDC",
+  "BNB",
+  "SHIB",
+  "POL",
+  "LTC",
+  "DAI",
+  "CRO",
+  "TRX",
+  "UNI"
+];
+var NETWORKS = ["BTC", "ETH", "BNB", "POL", "LTC", "CRO", "TRX"];
+var WALLET_TYPES = ["DIRECT_WALLET", "XPUB_WALLET"];
+var PRODUCT_CURRENCIES = ["USD", "EUR", "GBP", "CAD", "AUD", "JPY"];
+var paginationShape = {
+  page: z2.number().int().positive().optional(),
+  limit: z2.number().int().positive().max(100).optional(),
+  search: z2.string().optional().describe("Free-text search filter.")
+};
+function registerMerchantTools(server, billium) {
+  server.registerTool(
+    "list_customers",
+    {
+      title: "List customers",
+      description: "List the merchant\u2019s customers (auto-created from invoices) with pagination and optional search by email/name/phone/address.",
+      inputSchema: paginationShape
+    },
+    async (params) => {
+      try {
+        return ok(await billium.customers.list(params));
+      } catch (err) {
+        return fail(err);
+      }
+    }
+  );
+  server.registerTool(
+    "get_customer",
+    {
+      title: "Get customer",
+      description: "Fetch a single customer by ID, including derived location when known.",
+      inputSchema: { customerId: z2.string().describe("Customer ID (cus_...).") }
+    },
+    async ({ customerId }) => {
+      try {
+        return ok(await billium.customers.get(customerId));
+      } catch (err) {
+        return fail(err);
+      }
+    }
+  );
+  server.registerTool(
+    "get_customer_stats",
+    {
+      title: "Get customer stats",
+      description: "Get a customer\u2019s aggregate spend and invoice stats: total revenue from paid invoices, invoice counts, and paid rate.",
+      inputSchema: { customerId: z2.string().describe("Customer ID (cus_...).") }
+    },
+    async ({ customerId }) => {
+      try {
+        return ok(await billium.customers.stats(customerId));
+      } catch (err) {
+        return fail(err);
+      }
+    }
+  );
+  server.registerTool(
+    "update_customer",
+    {
+      title: "Update customer",
+      description: "Update a customer\u2019s name, address, or phone number. Email cannot be changed (it is the key that ties a customer to their invoices).",
+      inputSchema: {
+        customerId: z2.string().describe("Customer ID (cus_...)."),
+        name: z2.string().optional(),
+        address: z2.string().optional(),
+        phoneNumber: z2.string().optional()
+      }
+    },
+    async ({ customerId, ...params }) => {
+      try {
+        return ok(await billium.customers.update(customerId, params));
+      } catch (err) {
+        return fail(err);
+      }
+    }
+  );
+  server.registerTool(
+    "create_product",
+    {
+      title: "Create product",
+      description: "Create a product the merchant can sell through a hosted checkout page. Price is a fiat amount; the customer pays the crypto equivalent.",
+      inputSchema: {
+        name: z2.string().describe("Product display name."),
+        price: z2.number().positive().describe("Fiat price (e.g. 19.99). Returned as a string."),
+        currency: z2.enum(PRODUCT_CURRENCIES).optional(),
+        description: z2.string().optional(),
+        image: z2.string().optional().describe("Storage key of a previously uploaded image."),
+        isActive: z2.boolean().optional(),
+        askForName: z2.boolean().optional(),
+        askForAddress: z2.boolean().optional(),
+        askForPhoneNumber: z2.boolean().optional()
+      }
+    },
+    async (params) => {
+      try {
+        return ok(await billium.products.create(params));
+      } catch (err) {
+        return fail(err);
+      }
+    }
+  );
+  server.registerTool(
+    "get_product",
+    {
+      title: "Get product",
+      description: "Fetch a single product by ID (with a presigned image URL).",
+      inputSchema: { productId: z2.string().describe("Product ID (prd_...).") }
+    },
+    async ({ productId }) => {
+      try {
+        return ok(await billium.products.get(productId));
+      } catch (err) {
+        return fail(err);
+      }
+    }
+  );
+  server.registerTool(
+    "list_products",
+    {
+      title: "List products",
+      description: "List the merchant\u2019s products with pagination and optional search.",
+      inputSchema: paginationShape
+    },
+    async (params) => {
+      try {
+        return ok(await billium.products.list(params));
+      } catch (err) {
+        return fail(err);
+      }
+    }
+  );
+  server.registerTool(
+    "update_product",
+    {
+      title: "Update product",
+      description: "Update a product. Only the fields you pass are changed.",
+      inputSchema: {
+        productId: z2.string().describe("Product ID (prd_...)."),
+        name: z2.string().optional(),
+        price: z2.number().positive().optional(),
+        currency: z2.enum(PRODUCT_CURRENCIES).optional(),
+        description: z2.string().optional(),
+        image: z2.string().optional(),
+        isActive: z2.boolean().optional(),
+        askForName: z2.boolean().optional(),
+        askForAddress: z2.boolean().optional(),
+        askForPhoneNumber: z2.boolean().optional()
+      }
+    },
+    async ({ productId, ...params }) => {
+      try {
+        return ok(await billium.products.update(productId, params));
+      } catch (err) {
+        return fail(err);
+      }
+    }
+  );
+  server.registerTool(
+    "delete_product",
+    {
+      title: "Delete product",
+      description: "Delete a product.",
+      inputSchema: { productId: z2.string().describe("Product ID (prd_...).") }
+    },
+    async ({ productId }) => {
+      try {
+        return ok(await billium.products.delete(productId));
+      } catch (err) {
+        return fail(err);
+      }
+    }
+  );
+  server.registerTool(
+    "list_wallets",
+    {
+      title: "List wallets",
+      description: "List the merchant\u2019s crypto wallet configurations (DIRECT_WALLET / XPUB_WALLET). Only public config is returned \u2014 never private keys.",
+      inputSchema: {}
+    },
+    async () => {
+      try {
+        return ok(await billium.wallets.list());
+      } catch (err) {
+        return fail(err);
+      }
+    }
+  );
+  server.registerTool(
+    "get_wallet",
+    {
+      title: "Get wallet",
+      description: "Fetch a single wallet configuration by ID.",
+      inputSchema: { walletId: z2.string().describe("Wallet ID (wal_...).") }
+    },
+    async ({ walletId }) => {
+      try {
+        return ok(await billium.wallets.get(walletId));
+      } catch (err) {
+        return fail(err);
+      }
+    }
+  );
+  server.registerTool(
+    "create_wallet",
+    {
+      title: "Create wallet",
+      description: "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.",
+      inputSchema: {
+        cryptocurrency: z2.enum(CRYPTOCURRENCIES),
+        network: z2.enum(NETWORKS),
+        walletType: z2.enum(WALLET_TYPES),
+        address: z2.string().optional().describe("Required for DIRECT_WALLET."),
+        xpub: z2.string().optional().describe("Extended PUBLIC key \u2014 required for XPUB_WALLET (BTC/LTC)."),
+        derivationPath: z2.string().optional(),
+        isEnabled: z2.boolean().optional(),
+        requiredConfirmations: z2.number().int().min(1).max(100).optional()
+      }
+    },
+    async (params) => {
+      try {
+        return ok(await billium.wallets.create(params));
+      } catch (err) {
+        return fail(err);
+      }
+    }
+  );
+  server.registerTool(
+    "update_wallet",
+    {
+      title: "Update wallet",
+      description: "Update a wallet\u2019s mutable config (address, xpub, enabled state, confirmations, derivation path). Identity fields cannot change.",
+      inputSchema: {
+        walletId: z2.string().describe("Wallet ID (wal_...)."),
+        address: z2.string().optional(),
+        xpub: z2.string().optional(),
+        isEnabled: z2.boolean().optional(),
+        requiredConfirmations: z2.number().int().min(1).max(100).optional(),
+        derivationPath: z2.string().optional()
+      }
+    },
+    async ({ walletId, ...params }) => {
+      try {
+        return ok(await billium.wallets.update(walletId, params));
+      } catch (err) {
+        return fail(err);
+      }
+    }
+  );
+  server.registerTool(
+    "delete_wallet",
+    {
+      title: "Delete wallet",
+      description: "Delete a wallet. Rejected if it still has active payments against it.",
+      inputSchema: { walletId: z2.string().describe("Wallet ID (wal_...).") }
+    },
+    async ({ walletId }) => {
+      try {
+        return ok(await billium.wallets.delete(walletId));
+      } catch (err) {
+        return fail(err);
+      }
+    }
+  );
+}
+
+// src/version.ts
+var MCP_VERSION = "0.1.0";
+
+// src/server.ts
+function createServer(billium) {
+  const server = new McpServer({
+    name: "billium",
+    version: MCP_VERSION
+  });
+  registerTools(server, billium);
+  registerMerchantTools(server, billium);
+  return server;
+}
+
+// src/index.ts
+async function main() {
+  const billium = billiumFromEnv();
+  const server = createServer(billium);
+  const transport = new StdioServerTransport();
+  await server.connect(transport);
+  console.error("Billium MCP server running on stdio.");
+}
+main().catch((err) => {
+  console.error(
+    "Failed to start Billium MCP server:",
+    err instanceof Error ? err.message : err
+  );
+  process.exit(1);
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts","../src/config.ts","../src/server.ts","../src/tools.ts","../src/tools-merchant.ts","../src/version.ts"],"sourcesContent":["import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';\n\nimport { billiumFromEnv } from './config';\nimport { createServer } from './server';\n\nasync function main(): Promise<void> {\n  const billium = billiumFromEnv();\n  const server = createServer(billium);\n\n  const transport = new StdioServerTransport();\n  await server.connect(transport);\n\n  // stdout is the MCP protocol channel — all human-readable logging must go to\n  // stderr so it never corrupts the JSON-RPC stream.\n  console.error('Billium MCP server running on stdio.');\n}\n\nmain().catch((err: unknown) => {\n  console.error(\n    'Failed to start Billium MCP server:',\n    err instanceof Error ? err.message : err,\n  );\n  process.exit(1);\n});\n","import { Billium } from '@billium/node';\n\n/**\n * Builds a Billium SDK client from environment variables.\n *\n * Required:\n *   BILLIUM_API_KEY      — secret API key (sk_...)\n *   BILLIUM_MERCHANT_ID  — merchant ID (mer_...)\n * Optional:\n *   BILLIUM_BASE_URL     — override the API base URL (self-hosted / testing)\n *\n * Throws a clear error (listing what's missing) so misconfiguration fails fast\n * at startup rather than as a confusing 401 on the first tool call.\n */\nexport function billiumFromEnv(env: NodeJS.ProcessEnv = process.env): Billium {\n  const apiKey = env.BILLIUM_API_KEY?.trim();\n  const merchantId = env.BILLIUM_MERCHANT_ID?.trim();\n\n  const missing: string[] = [];\n  if (!apiKey) missing.push('BILLIUM_API_KEY');\n  if (!merchantId) missing.push('BILLIUM_MERCHANT_ID');\n  if (missing.length > 0) {\n    throw new Error(\n      `Missing required environment variable(s): ${missing.join(', ')}. ` +\n        'Generate a secret API key in the Billium dashboard under ' +\n        'Settings → Developer → API keys.',\n    );\n  }\n\n  return new Billium({\n    apiKey,\n    merchantId,\n    baseUrl: env.BILLIUM_BASE_URL?.trim() || undefined,\n  });\n}\n","import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';\nimport type { Billium } from '@billium/node';\n\nimport { registerTools } from './tools';\nimport { registerMerchantTools } from './tools-merchant';\nimport { MCP_VERSION } from './version';\n\n/**\n * Builds the Billium MCP server and registers every tool against the given SDK\n * client. Transport-agnostic — `index.ts` connects it over stdio in production,\n * and tests connect it over an in-memory transport.\n */\nexport function createServer(billium: Billium): McpServer {\n  const server = new McpServer({\n    name: 'billium',\n    version: MCP_VERSION,\n  });\n\n  registerTools(server, billium);\n  registerMerchantTools(server, billium);\n\n  return server;\n}\n","import { randomUUID } from 'node:crypto';\nimport { z } from 'zod';\nimport type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';\nimport type { Billium, WebhookEventType } from '@billium/node';\n\n/**\n * The 17 webhook event types Billium emits, plus the two category wildcards.\n * Kept in sync with `@billium/node`'s `WebhookEventType` union.\n */\nconst WEBHOOK_EVENTS: [WebhookEventType, ...WebhookEventType[]] = [\n  'invoice.*',\n  'invoice.created',\n  'invoice.updated',\n  'invoice.paid',\n  'invoice.underpaid',\n  'invoice.overpaid',\n  'invoice.expired',\n  'invoice.cancelled',\n  'payment.*',\n  'payment.created',\n  'payment.updated',\n  'payment.detected',\n  'payment.confirmed',\n  'payment.paid',\n  'payment.underpaid',\n  'payment.overpaid',\n  'payment.expired',\n];\n\nexport type ToolResult = {\n  content: { type: 'text'; text: string }[];\n  isError?: boolean;\n};\n\nexport function ok(data: unknown): ToolResult {\n  const text =\n    typeof data === 'string' ? data : JSON.stringify(data, null, 2);\n  return { content: [{ type: 'text', text }] };\n}\n\nexport function fail(err: unknown): ToolResult {\n  // Duck-type the SDK's error shape (BilliumApiError carries `status`) so we\n  // surface actionable messages without a runtime import of the SDK.\n  const status = (err as { status?: number })?.status;\n  const message = err instanceof Error ? err.message : String(err);\n  const text = status\n    ? `Billium API error (${status}): ${message}`\n    : `Billium error: ${message}`;\n  return { content: [{ type: 'text', text }], isError: true };\n}\n\n/**\n * Registers every Billium tool on the given MCP server, backed by the supplied\n * SDK client. Split out from the transport wiring so tests can drive it with an\n * in-memory client and a mock `Billium`.\n */\nexport function registerTools(server: McpServer, billium: Billium): void {\n  // ─── Invoices ──────────────────────────────────────────────────────────\n\n  server.registerTool(\n    'create_invoice',\n    {\n      title: 'Create invoice',\n      description:\n        'Create a new crypto payment invoice for the merchant and return it, ' +\n        'including the hosted checkout URL. The customer pays in crypto; ' +\n        'settlement is non-custodial (funds go straight to the merchant wallet). ' +\n        'An idempotency key is generated automatically unless you pass one.',\n      inputSchema: {\n        name: z.string().describe('Invoice display name, e.g. \"Order #1234\".'),\n        rawAmount: z\n          .number()\n          .positive()\n          .describe('Amount in the given currency (e.g. 99.99).'),\n        currency: z\n          .string()\n          .optional()\n          .describe(\"Currency code, e.g. 'USD'. Defaults to USD.\"),\n        customerEmail: z.string().email().optional(),\n        customerName: z.string().optional(),\n        customerAddress: z.string().optional(),\n        customerPhoneNumber: z.string().optional(),\n        description: z.string().optional(),\n        redirectUrl: z\n          .string()\n          .url()\n          .optional()\n          .describe('URL to send the customer to after a successful payment.'),\n        idempotencyKey: z\n          .string()\n          .optional()\n          .describe(\n            'Optional dedup key. If omitted, a UUID is generated so retries ' +\n              'never create duplicate invoices.',\n          ),\n      },\n    },\n    async ({ idempotencyKey, ...params }) => {\n      try {\n        const invoice = await billium.invoices.create(params, {\n          idempotencyKey: idempotencyKey ?? randomUUID(),\n        });\n        return ok(invoice);\n      } catch (err) {\n        return fail(err);\n      }\n    },\n  );\n\n  server.registerTool(\n    'get_invoice',\n    {\n      title: 'Get invoice',\n      description:\n        'Fetch a single invoice by ID, including its current status, ' +\n        'customer, payments, and status timeline.',\n      inputSchema: {\n        invoiceId: z.string().describe('The invoice ID (inv_...).'),\n      },\n    },\n    async ({ invoiceId }) => {\n      try {\n        return ok(await billium.invoices.get(invoiceId));\n      } catch (err) {\n        return fail(err);\n      }\n    },\n  );\n\n  server.registerTool(\n    'list_invoices',\n    {\n      title: 'List invoices',\n      description:\n        'List the merchant’s invoices with pagination and optional search. ' +\n        'Returns a page of invoices plus total/page metadata.',\n      inputSchema: {\n        page: z.number().int().positive().optional(),\n        limit: z\n          .number()\n          .int()\n          .positive()\n          .max(100)\n          .optional()\n          .describe('Results per page (max 100). Defaults to 10.'),\n        search: z\n          .string()\n          .optional()\n          .describe('Filter by invoice name, description, or ID.'),\n      },\n    },\n    async (params) => {\n      try {\n        return ok(await billium.invoices.list(params));\n      } catch (err) {\n        return fail(err);\n      }\n    },\n  );\n\n  server.registerTool(\n    'cancel_invoice',\n    {\n      title: 'Cancel invoice',\n      description:\n        'Cancel an invoice that has not yet been paid. Returns the updated ' +\n        'invoice. Already-terminal invoices (paid/expired/cancelled) cannot ' +\n        'be cancelled.',\n      inputSchema: {\n        invoiceId: z.string().describe('The invoice ID (inv_...).'),\n      },\n    },\n    async ({ invoiceId }) => {\n      try {\n        return ok(await billium.invoices.cancel(invoiceId));\n      } catch (err) {\n        return fail(err);\n      }\n    },\n  );\n\n  // ─── Webhooks ──────────────────────────────────────────────────────────\n\n  server.registerTool(\n    'create_webhook',\n    {\n      title: 'Create webhook',\n      description:\n        'Register a webhook endpoint that Billium will POST events to. Use ' +\n        \"'invoice.*' or 'payment.*' to subscribe to every event in a category.\",\n      inputSchema: {\n        url: z.string().url().describe('HTTPS URL Billium will POST events to.'),\n        events: z\n          .array(z.enum(WEBHOOK_EVENTS))\n          .nonempty()\n          .describe('Event types to subscribe to.'),\n        description: z.string().optional(),\n        isActive: z.boolean().optional(),\n        retryCount: z.number().int().min(0).max(10).optional(),\n        timeout: z.number().int().min(1000).max(30000).optional(),\n      },\n    },\n    async (params) => {\n      try {\n        return ok(await billium.webhooks.create(params));\n      } catch (err) {\n        return fail(err);\n      }\n    },\n  );\n\n  server.registerTool(\n    'list_webhooks',\n    {\n      title: 'List webhooks',\n      description: 'List all webhook endpoints configured for the merchant.',\n      inputSchema: {},\n    },\n    async () => {\n      try {\n        return ok(await billium.webhooks.list());\n      } catch (err) {\n        return fail(err);\n      }\n    },\n  );\n\n  server.registerTool(\n    'update_webhook',\n    {\n      title: 'Update webhook',\n      description:\n        'Update an existing webhook endpoint (URL, subscribed events, active ' +\n        'state, retries, or timeout). Only the fields you pass are changed.',\n      inputSchema: {\n        webhookId: z.string().describe('The webhook ID (wh_...).'),\n        url: z.string().url().optional(),\n        events: z.array(z.enum(WEBHOOK_EVENTS)).nonempty().optional(),\n        description: z.string().optional(),\n        isActive: z.boolean().optional(),\n        retryCount: z.number().int().min(0).max(10).optional(),\n        timeout: z.number().int().min(1000).max(30000).optional(),\n      },\n    },\n    async ({ webhookId, ...params }) => {\n      try {\n        return ok(await billium.webhooks.update(webhookId, params));\n      } catch (err) {\n        return fail(err);\n      }\n    },\n  );\n\n  server.registerTool(\n    'delete_webhook',\n    {\n      title: 'Delete webhook',\n      description: 'Permanently delete a webhook endpoint.',\n      inputSchema: {\n        webhookId: z.string().describe('The webhook ID (wh_...).'),\n      },\n    },\n    async ({ webhookId }) => {\n      try {\n        await billium.webhooks.delete(webhookId);\n        return ok(`Webhook ${webhookId} deleted.`);\n      } catch (err) {\n        return fail(err);\n      }\n    },\n  );\n\n  server.registerTool(\n    'ping_webhook',\n    {\n      title: 'Ping webhook',\n      description:\n        'Send a test event to a webhook endpoint to verify it is reachable ' +\n        'and that your signature verification works.',\n      inputSchema: {\n        webhookId: z.string().describe('The webhook ID (wh_...).'),\n      },\n    },\n    async ({ webhookId }) => {\n      try {\n        await billium.webhooks.ping(webhookId);\n        return ok(`Ping sent to webhook ${webhookId}.`);\n      } catch (err) {\n        return fail(err);\n      }\n    },\n  );\n}\n","import { z } from 'zod';\nimport type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';\nimport type { Billium } from '@billium/node';\n\nimport { ok, fail } from './tools';\n\n// Enums mirrored from @billium/node so tool inputs are validated up front.\nconst CRYPTOCURRENCIES = [\n  'BTC',\n  'ETH',\n  'USDT',\n  'USDC',\n  'BNB',\n  'SHIB',\n  'POL',\n  'LTC',\n  'DAI',\n  'CRO',\n  'TRX',\n  'UNI',\n] as const;\nconst NETWORKS = ['BTC', 'ETH', 'BNB', 'POL', 'LTC', 'CRO', 'TRX'] as const;\nconst WALLET_TYPES = ['DIRECT_WALLET', 'XPUB_WALLET'] as const;\nconst PRODUCT_CURRENCIES = ['USD', 'EUR', 'GBP', 'CAD', 'AUD', 'JPY'] as const;\n\nconst paginationShape = {\n  page: z.number().int().positive().optional(),\n  limit: z.number().int().positive().max(100).optional(),\n  search: z.string().optional().describe('Free-text search filter.'),\n};\n\n/**\n * Registers the merchant data-resource tools (customers, products, wallets)\n * on top of the core invoice/webhook tools. Kept separate from `tools.ts` so\n * each domain stays readable; both are registered by `createServer`.\n */\nexport function registerMerchantTools(\n  server: McpServer,\n  billium: Billium,\n): void {\n  // ─── Customers ─────────────────────────────────────────────────────────\n  // Customers are auto-provisioned from invoices — there is no create/delete,\n  // only list/get/stats/update.\n\n  server.registerTool(\n    'list_customers',\n    {\n      title: 'List customers',\n      description:\n        'List the merchant’s customers (auto-created from invoices) with ' +\n        'pagination and optional search by email/name/phone/address.',\n      inputSchema: paginationShape,\n    },\n    async (params) => {\n      try {\n        return ok(await billium.customers.list(params));\n      } catch (err) {\n        return fail(err);\n      }\n    },\n  );\n\n  server.registerTool(\n    'get_customer',\n    {\n      title: 'Get customer',\n      description:\n        'Fetch a single customer by ID, including derived location when known.',\n      inputSchema: { customerId: z.string().describe('Customer ID (cus_...).') },\n    },\n    async ({ customerId }) => {\n      try {\n        return ok(await billium.customers.get(customerId));\n      } catch (err) {\n        return fail(err);\n      }\n    },\n  );\n\n  server.registerTool(\n    'get_customer_stats',\n    {\n      title: 'Get customer stats',\n      description:\n        'Get a customer’s aggregate spend and invoice stats: total revenue ' +\n        'from paid invoices, invoice counts, and paid rate.',\n      inputSchema: { customerId: z.string().describe('Customer ID (cus_...).') },\n    },\n    async ({ customerId }) => {\n      try {\n        return ok(await billium.customers.stats(customerId));\n      } catch (err) {\n        return fail(err);\n      }\n    },\n  );\n\n  server.registerTool(\n    'update_customer',\n    {\n      title: 'Update customer',\n      description:\n        'Update a customer’s name, address, or phone number. Email cannot be ' +\n        'changed (it is the key that ties a customer to their invoices).',\n      inputSchema: {\n        customerId: z.string().describe('Customer ID (cus_...).'),\n        name: z.string().optional(),\n        address: z.string().optional(),\n        phoneNumber: z.string().optional(),\n      },\n    },\n    async ({ customerId, ...params }) => {\n      try {\n        return ok(await billium.customers.update(customerId, params));\n      } catch (err) {\n        return fail(err);\n      }\n    },\n  );\n\n  // ─── Products ──────────────────────────────────────────────────────────\n\n  server.registerTool(\n    'create_product',\n    {\n      title: 'Create product',\n      description:\n        'Create a product the merchant can sell through a hosted checkout ' +\n        'page. Price is a fiat amount; the customer pays the crypto equivalent.',\n      inputSchema: {\n        name: z.string().describe('Product display name.'),\n        price: z\n          .number()\n          .positive()\n          .describe('Fiat price (e.g. 19.99). Returned as a string.'),\n        currency: z.enum(PRODUCT_CURRENCIES).optional(),\n        description: z.string().optional(),\n        image: z\n          .string()\n          .optional()\n          .describe('Storage key of a previously uploaded image.'),\n        isActive: z.boolean().optional(),\n        askForName: z.boolean().optional(),\n        askForAddress: z.boolean().optional(),\n        askForPhoneNumber: z.boolean().optional(),\n      },\n    },\n    async (params) => {\n      try {\n        return ok(await billium.products.create(params));\n      } catch (err) {\n        return fail(err);\n      }\n    },\n  );\n\n  server.registerTool(\n    'get_product',\n    {\n      title: 'Get product',\n      description: 'Fetch a single product by ID (with a presigned image URL).',\n      inputSchema: { productId: z.string().describe('Product ID (prd_...).') },\n    },\n    async ({ productId }) => {\n      try {\n        return ok(await billium.products.get(productId));\n      } catch (err) {\n        return fail(err);\n      }\n    },\n  );\n\n  server.registerTool(\n    'list_products',\n    {\n      title: 'List products',\n      description:\n        'List the merchant’s products with pagination and optional search.',\n      inputSchema: paginationShape,\n    },\n    async (params) => {\n      try {\n        return ok(await billium.products.list(params));\n      } catch (err) {\n        return fail(err);\n      }\n    },\n  );\n\n  server.registerTool(\n    'update_product',\n    {\n      title: 'Update product',\n      description:\n        'Update a product. Only the fields you pass are changed.',\n      inputSchema: {\n        productId: z.string().describe('Product ID (prd_...).'),\n        name: z.string().optional(),\n        price: z.number().positive().optional(),\n        currency: z.enum(PRODUCT_CURRENCIES).optional(),\n        description: z.string().optional(),\n        image: z.string().optional(),\n        isActive: z.boolean().optional(),\n        askForName: z.boolean().optional(),\n        askForAddress: z.boolean().optional(),\n        askForPhoneNumber: z.boolean().optional(),\n      },\n    },\n    async ({ productId, ...params }) => {\n      try {\n        return ok(await billium.products.update(productId, params));\n      } catch (err) {\n        return fail(err);\n      }\n    },\n  );\n\n  server.registerTool(\n    'delete_product',\n    {\n      title: 'Delete product',\n      description: 'Delete a product.',\n      inputSchema: { productId: z.string().describe('Product ID (prd_...).') },\n    },\n    async ({ productId }) => {\n      try {\n        return ok(await billium.products.delete(productId));\n      } catch (err) {\n        return fail(err);\n      }\n    },\n  );\n\n  // ─── Wallets ───────────────────────────────────────────────────────────\n\n  server.registerTool(\n    'list_wallets',\n    {\n      title: 'List wallets',\n      description:\n        'List the merchant’s crypto wallet configurations (DIRECT_WALLET / ' +\n        'XPUB_WALLET). Only public config is returned — never private keys.',\n      inputSchema: {},\n    },\n    async () => {\n      try {\n        return ok(await billium.wallets.list());\n      } catch (err) {\n        return fail(err);\n      }\n    },\n  );\n\n  server.registerTool(\n    'get_wallet',\n    {\n      title: 'Get wallet',\n      description: 'Fetch a single wallet configuration by ID.',\n      inputSchema: { walletId: z.string().describe('Wallet ID (wal_...).') },\n    },\n    async ({ walletId }) => {\n      try {\n        return ok(await billium.wallets.get(walletId));\n      } catch (err) {\n        return fail(err);\n      }\n    },\n  );\n\n  server.registerTool(\n    'create_wallet',\n    {\n      title: 'Create wallet',\n      description:\n        'Add a receiving wallet for a (cryptocurrency, network) pair. Pass ' +\n        '`address` for a DIRECT_WALLET, or `xpub` (extended PUBLIC key) for an ' +\n        'XPUB_WALLET. One wallet per pair.',\n      inputSchema: {\n        cryptocurrency: z.enum(CRYPTOCURRENCIES),\n        network: z.enum(NETWORKS),\n        walletType: z.enum(WALLET_TYPES),\n        address: z\n          .string()\n          .optional()\n          .describe('Required for DIRECT_WALLET.'),\n        xpub: z\n          .string()\n          .optional()\n          .describe('Extended PUBLIC key — required for XPUB_WALLET (BTC/LTC).'),\n        derivationPath: z.string().optional(),\n        isEnabled: z.boolean().optional(),\n        requiredConfirmations: z.number().int().min(1).max(100).optional(),\n      },\n    },\n    async (params) => {\n      try {\n        return ok(await billium.wallets.create(params));\n      } catch (err) {\n        return fail(err);\n      }\n    },\n  );\n\n  server.registerTool(\n    'update_wallet',\n    {\n      title: 'Update wallet',\n      description:\n        'Update a wallet’s mutable config (address, xpub, enabled state, ' +\n        'confirmations, derivation path). Identity fields cannot change.',\n      inputSchema: {\n        walletId: z.string().describe('Wallet ID (wal_...).'),\n        address: z.string().optional(),\n        xpub: z.string().optional(),\n        isEnabled: z.boolean().optional(),\n        requiredConfirmations: z.number().int().min(1).max(100).optional(),\n        derivationPath: z.string().optional(),\n      },\n    },\n    async ({ walletId, ...params }) => {\n      try {\n        return ok(await billium.wallets.update(walletId, params));\n      } catch (err) {\n        return fail(err);\n      }\n    },\n  );\n\n  server.registerTool(\n    'delete_wallet',\n    {\n      title: 'Delete wallet',\n      description:\n        'Delete a wallet. Rejected if it still has active payments against it.',\n      inputSchema: { walletId: z.string().describe('Wallet ID (wal_...).') },\n    },\n    async ({ walletId }) => {\n      try {\n        return ok(await billium.wallets.delete(walletId));\n      } catch (err) {\n        return fail(err);\n      }\n    },\n  );\n}\n","// Kept in sync with package.json `version`.\nexport const MCP_VERSION = '0.1.0';\n"],"mappings":"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","names":["z","z"]}

package/package.json

@@ -0,0 +1,65 @@
+{
+  "name": "@billium/mcp",
+  "version": "0.1.0",
+  "description": "Official Billium MCP server — manage crypto invoices and webhooks from Claude, Cursor, and any MCP host.",
+  "keywords": [
+    "billium",
+    "mcp",
+    "model-context-protocol",
+    "claude",
+    "cursor",
+    "crypto",
+    "payments",
+    "invoice",
+    "webhook",
+    "ai",
+    "agent"
+  ],
+  "license": "MIT",
+  "author": "Billium <hello@billium.to>",
+  "homepage": "https://billium.to",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/BilliumHQ/billium-node.git",
+    "directory": "packages/mcp"
+  },
+  "bugs": {
+    "url": "https://github.com/BilliumHQ/billium-node/issues"
+  },
+  "type": "module",
+  "bin": {
+    "billium-mcp": "dist/index.js"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE",
+    "CHANGELOG.md"
+  ],
+  "publishConfig": {
+    "access": "public",
+    "provenance": true
+  },
+  "scripts": {
+    "build": "tsup",
+    "build:watch": "tsup --watch",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "lint": "tsc --noEmit",
+    "prepublishOnly": "npm run build"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "dependencies": {
+    "@billium/node": "^1.0.1",
+    "@modelcontextprotocol/sdk": "^1.29.0",
+    "zod": "^3.23.0"
+  },
+  "devDependencies": {
+    "@types/node": "^20.0.0",
+    "tsup": "^8.0.0",
+    "typescript": "^5.4.0",
+    "vitest": "^1.5.0"
+  }
+}