{
  "markdown": "# Billium SDKs\n\nOfficial client libraries for [Billium](https://billium.to) — non-custodial crypto payments, invoices, and webhooks.\n\n## Packages\n\n| Package | Version | Description |\n|---|---|---|\n| [`@billium/node`](./packages/node) | [![npm](https://img.shields.io/npm/v/@billium/node.svg)](https://www.npmjs.com/package/@billium/node) | Node.js SDK — invoices, webhook signature verification, webhook management |\n| [`@billium/mcp`](./packages/mcp) | [![npm](https://img.shields.io/npm/v/@billium/mcp.svg)](https://www.npmjs.com/package/@billium/mcp) | MCP server — manage invoices and webhooks from Claude, Cursor, and any MCP host |\n\nAdditional language SDKs will live as siblings under `packages/` as they ship.\n\n## Quick start\n\n```bash\nnpm install @billium/node\n```\n\n```typescript\nimport { Billium } from '@billium/node';\n\nconst billium = new Billium({\n  apiKey: process.env.BILLIUM_API_KEY,\n  merchantId: process.env.BILLIUM_MERCHANT_ID,\n  webhookSecret: process.env.BILLIUM_WEBHOOK_SECRET,\n});\n\nconst invoice = await billium.invoices.create(\n  { name: 'Order #1234', rawAmount: 99.99 },\n  { idempotencyKey: crypto.randomUUID() },\n);\n```\n\nSee [`packages/node/README.md`](./packages/node/README.md) for the full Node.js SDK reference.\n\n## Repository layout\n\n```\n.\n├── packages/\n│   ├── node/              # @billium/node — TypeScript Node.js SDK\n│   │   ├── src/           # Source\n│   │   ├── tests/         # Vitest test suite\n│   │   ├── README.md      # Public-facing docs (rendered on npmjs.com)\n│   │   └── CHANGELOG.md   # Per-release notes\n│   └── mcp/               # @billium/mcp — Model Context Protocol server\n│       ├── src/           # Server + tool definitions\n│       ├── tests/         # Vitest in-memory round-trip suite\n│       └── README.md      # Host setup (Claude Code, Cursor, …)\n└── .github/\n    ├── workflows/         # CI + release automation\n    ├── ISSUE_TEMPLATE/    # Bug + feature request forms\n    └── CODEOWNERS         # Review requirements\n```\n\n## Development\n\nThis is an npm workspace. Run scripts from the repository root:\n\n```bash\nnpm install        # installs all workspace packages\nnpm run lint       # typechecks every package (src + tests)\nnpm test           # runs every package's test suite\nnpm run build      # builds every package\n```\n\nTo work on a specific package, you can also `cd packages/node && npm <script>`.\n\n### Releasing\n\nReleases are published to npm by GitHub Actions when a `v*.*.*` tag is pushed:\n\n1. Bump `packages/node/package.json#version` **and** `packages/node/src/version.ts#SDK_VERSION` to the new version (CI verifies they match).\n2. Add a section to `packages/node/CHANGELOG.md` describing the changes.\n3. Commit the bump on `main`.\n4. Tag and push: `git tag v1.0.1 && git push origin v1.0.1`.\n5. The release workflow runs lint, test, build, then `npm publish` with provenance.\n\n## License\n\n[MIT](./LICENSE)\n",
  "bytes": 2886,
  "sha": "eaca9a986af865994df91e43709ce6ead377a1d6c82601031e31807aff473716",
  "repo_slug": "billiumhq/billium-node",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_billiumhq_billium_a70a483e/readme"
}