{"_id":"@daniel.barta/billingo-mcp","name":"@daniel.barta/billingo-mcp","dist-tags":{"latest":"1.0.0"},"versions":{"1.0.0":{"name":"@daniel.barta/billingo-mcp","version":"1.0.0","description":"MCP server for the Billingo V3 Hungarian invoicing API","type":"module","main":"dist/index.js","bin":{"billingo-mcp":"bin/billingo-mcp.js"},"scripts":{"build":"tsc","dev":"BILLINGO_MOCK=true node --loader ts-node/esm src/index.ts"},"dependencies":{"@codingsans/billingo-client":"^2.1.0","@modelcontextprotocol/sdk":"^1.12.1","axios":"^1.13.6","zod":"^3.24.4"},"devDependencies":{"ts-node":"^10.9.2","typescript":"^5.8.3"},"keywords":["billingo","mcp","invoicing","hungary","model-context-protocol","claude"],"license":"MIT","author":{"name":"Daniel Barta"},"repository":{"type":"git","url":"git+https://github.com/bartadaniel/billingo-mcp.git"},"engines":{"node":">=20.0.0"},"gitHead":"18210c5c4763bd0a0687f18dea953da8b6828ce4","types":"./dist/index.d.ts","_id":"@daniel.barta/billingo-mcp@1.0.0","bugs":{"url":"https://github.com/bartadaniel/billingo-mcp/issues"},"homepage":"https://github.com/bartadaniel/billingo-mcp#readme","_nodeVersion":"25.8.0","_npmVersion":"11.11.0","dist":{"integrity":"sha512-qxrMxSEnzps2DGvDpHiyCz++25PXUkPA76zANV23eWA/tKmPeTA+DN7PRjbbeO/OcFro36g8Jy3q3Gkb/NpLzg==","shasum":"70a46e996814646caf4271f8e26a9b37550641d8","tarball":"https://registry.npmjs.org/@daniel.barta/billingo-mcp/-/billingo-mcp-1.0.0.tgz","fileCount":58,"unpackedSize":116367,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEQCIAZjv1NEkr0GpJOW4TutqaiIp94FKSG+eyQb8M2DwHzbAiARS7WnydbrCHtY9i7CNCXLx2cWKl481t7+u/9fcpkO+g=="}]},"_npmUser":{"name":"daniel.barta","email":"barta.daniel@gmail.com"},"directories":{},"maintainers":[{"name":"daniel.barta","email":"barta.daniel@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/billingo-mcp_1.0.0_1774311229939_0.31676130270447467"},"_hasShrinkwrap":false}},"time":{"created":"2026-03-24T00:13:49.873Z","1.0.0":"2026-03-24T00:13:50.099Z","modified":"2026-03-24T00:13:50.283Z"},"maintainers":[{"name":"daniel.barta","email":"barta.daniel@gmail.com"}],"description":"MCP server for the Billingo V3 Hungarian invoicing API","homepage":"https://github.com/bartadaniel/billingo-mcp#readme","keywords":["billingo","mcp","invoicing","hungary","model-context-protocol","claude"],"repository":{"type":"git","url":"git+https://github.com/bartadaniel/billingo-mcp.git"},"author":{"name":"Daniel Barta"},"bugs":{"url":"https://github.com/bartadaniel/billingo-mcp/issues"},"license":"MIT","readme":"# billingo-mcp\n\n[![npm](https://img.shields.io/npm/v/@daniel.barta/billingo-mcp)](https://www.npmjs.com/package/@daniel.barta/billingo-mcp)\n\nMCP server for the [Billingo](https://www.billingo.hu) V3 Hungarian invoicing API. Manage invoices, partners, products, spendings, and bank accounts from any MCP client.\n\n## Quick Start\n\n1. Get your API key from [Billingo API settings](https://app.billingo.hu/api-key)\n\n2. Add to your Claude Code settings (`~/.claude/settings.json`) or Claude Desktop config:\n\n```json\n{\n  \"mcpServers\": {\n    \"billingo\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@daniel.barta/billingo-mcp\"],\n      \"env\": {\n        \"BILLINGO_API_KEY\": \"your-api-key\"\n      }\n    }\n  }\n}\n```\n\n3. Restart Claude and start managing your invoices.\n\n## Configuration\n\n| Environment Variable | Required | Default | Description |\n|---------------------|----------|---------|-------------|\n| `BILLINGO_API_KEY` | Yes | -- | Your Billingo API key |\n| `BILLINGO_MOCK` | No | `false` | Set to `true` for mock mode (no API calls) |\n\nMock mode is activated automatically when no API key is provided, or explicitly with `BILLINGO_MOCK=true`. Useful for development and testing.\n\n## Tools\n\n### Documents\n\n| Tool | Description |\n|------|-------------|\n| `list_documents` | List invoices with filters (partner, status, date range, type, payment method) |\n| `create_document` | Create invoices, proformas, advance invoices, or drafts |\n| `get_document` | Get document details by ID |\n| `cancel_document` | Cancel (storno) a document |\n| `send_document` | Send document via email |\n| `download_document` | Download document as PDF |\n| `get_document_public_url` | Get public URL for a document |\n| `update_payment` | Record or update payment on a document |\n\n### Partners\n\n| Tool | Description |\n|------|-------------|\n| `list_partners` | List partners with search |\n| `create_partner` | Create a new partner (with address, tax info) |\n| `get_partner` | Get partner details by ID |\n| `update_partner` | Update an existing partner |\n\n### Products\n\n| Tool | Description |\n|------|-------------|\n| `list_products` | List products |\n| `create_product` | Create a new product |\n| `get_product` | Get product details by ID |\n| `update_product` | Update an existing product |\n\n### Spendings\n\n| Tool | Description |\n|------|-------------|\n| `list_spending` | List spendings with filters |\n| `create_spending` | Create a spending entry (with line items and VAT) |\n| `get_spending` | Get spending details by ID |\n\n### Bank Accounts\n\n| Tool | Description |\n|------|-------------|\n| `list_bank_accounts` | List bank accounts |\n| `create_bank_account` | Create a new bank account |\n| `get_bank_account` | Get bank account details by ID |\n| `update_bank_account` | Update an existing bank account |\n\n### Utilities\n\n| Tool | Description |\n|------|-------------|\n| `check_tax_number` | Validate a Hungarian tax number via NAV |\n| `get_organization` | Get your own organization data |\n| `get_currency_rates` | Get exchange rates |\n| `list_document_blocks` | List invoice numbering sequences |\n\n## Development\n\n```bash\ngit clone https://github.com/bartadaniel/billingo-mcp.git\ncd billingo-mcp\nnpm install\nnpm run build\n```\n\nUse the local build in your config:\n\n```json\n{\n  \"mcpServers\": {\n    \"billingo\": {\n      \"command\": \"node\",\n      \"args\": [\"path/to/billingo-mcp/bin/billingo-mcp.js\"],\n      \"env\": {\n        \"BILLINGO_API_KEY\": \"your-api-key\"\n      }\n    }\n  }\n}\n```\n\n### Mock Mode\n\nRun without an API key for development:\n\n```bash\nnpm run dev\n```\n\nThis starts the server with `BILLINGO_MOCK=true`, returning realistic fixture data for all tools.\n\n## License\n\nMIT\n","readmeFilename":"README.md","_rev":"1-be804f49313cbb583622629fff5d9c19"}