{"_id":"@companybelgium/mcp-server","name":"@companybelgium/mcp-server","dist-tags":{"latest":"0.1.0"},"versions":{"0.1.0":{"name":"@companybelgium/mcp-server","version":"0.1.0","description":"MCP server exposing the Company Belgium API (Belgian BCE/KBO lookup + Peppol check) to Claude and other MCP-compatible LLM clients.","type":"module","bin":{"companybelgium-mcp":"dist/index.js"},"scripts":{"build":"tsc -p tsconfig.json","dev":"tsx src/index.ts","start":"node dist/index.js","prepublishOnly":"pnpm build"},"engines":{"node":">=20"},"keywords":["mcp","model-context-protocol","claude","belgium","bce","kbo","peppol","companybelgium"],"author":{"name":"Espero-Soft Informatiques SRL"},"license":"MIT","homepage":"https://companybelgium.be","repository":{"type":"git","url":"git+https://github.com/espero-soft/companybelgium.git","directory":"packages/mcp-server"},"dependencies":{"@modelcontextprotocol/sdk":"^1.0.4","zod":"^3.23.8"},"devDependencies":{"@types/node":"^20.14.0","tsx":"^4.19.2","typescript":"^5.6.3"},"gitHead":"cbf6c7a5530147adb6d21b5209e3f8626a614685","_id":"@companybelgium/mcp-server@0.1.0","bugs":{"url":"https://github.com/espero-soft/companybelgium/issues"},"_nodeVersion":"25.2.1","_npmVersion":"11.6.2","dist":{"integrity":"sha512-yW628K6g/8KumJnyY0tmwfWre9fazoeCAnMxWlvubZDld7y+MeKep8Nf2o64nM54OwSZYhMLx+hqFk1eZkn7Kg==","shasum":"8d90368c8f18ea4fa0d14e99885b6d810ab22722","tarball":"https://registry.npmjs.org/@companybelgium/mcp-server/-/mcp-server-0.1.0.tgz","fileCount":11,"unpackedSize":30180,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEYCIQCKUG5UreiDm61rp/JpwLwXhLEIe+NUAsioc0LqHrxv8gIhALBc8s9LqPAxp2A/hYlH664CflJULzWXRHFmT03vELvt"}]},"_npmUser":{"name":"esperosoft","email":"contact@espero-soft.com"},"directories":{},"maintainers":[{"name":"esperosoft","email":"contact@espero-soft.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/mcp-server_0.1.0_1778999139304_0.06545410553671482"},"_hasShrinkwrap":false}},"time":{"created":"2026-05-17T06:25:39.218Z","0.1.0":"2026-05-17T06:25:39.445Z","modified":"2026-05-17T06:25:39.657Z"},"maintainers":[{"name":"esperosoft","email":"contact@espero-soft.com"}],"description":"MCP server exposing the Company Belgium API (Belgian BCE/KBO lookup + Peppol check) to Claude and other MCP-compatible LLM clients.","homepage":"https://companybelgium.be","keywords":["mcp","model-context-protocol","claude","belgium","bce","kbo","peppol","companybelgium"],"repository":{"type":"git","url":"git+https://github.com/espero-soft/companybelgium.git","directory":"packages/mcp-server"},"author":{"name":"Espero-Soft Informatiques SRL"},"bugs":{"url":"https://github.com/espero-soft/companybelgium/issues"},"license":"MIT","readme":"# @companybelgium/mcp-server\n\nMCP (Model Context Protocol) server that exposes the [Company Belgium](https://companybelgium.be) API — Belgian BCE/KBO company lookups and Peppol e-invoicing checks — to Claude Desktop, Claude Code, and any other MCP-compatible LLM client.\n\nAsk Claude *\"trouve-moi toutes les sociétés actives à Bruxelles dans le code NACE 62010\"* and it will call your account directly. Requests count against your normal Company Belgium plan quota — same pk/sk pair as the HTTP API, same rate-limit and billing rules.\n\n## What you can do\n\n| Tool | Purpose |\n| --- | --- |\n| `search_companies` | Search by name, postal code, city, NACE activity code |\n| `get_company` | Full BCE record by enterprise number |\n| `search_company_address` | Reverse-lookup companies at a given address |\n| `search_establishments` | Search operational units |\n| `get_establishment` | Full record for one establishment |\n| `check_peppol` | Verify whether a VAT number receives Peppol e-invoices |\n\nAll tools are read-only. Quota and rate-limit headers from the API are surfaced as friendly error messages when you hit your plan limit.\n\n## Install\n\nThe server runs on Node ≥ 20.\n\n```bash\nnpm install -g @companybelgium/mcp-server\n# or run on demand:\nnpx -y @companybelgium/mcp-server\n```\n\nGet an API key pair at <https://companybelgium.be/dashboard/api-keys>.\n\n## Configure Claude Desktop\n\nEdit `~/Library/Application Support/Claude/claude_desktop_config.json` (macOS) or `%APPDATA%\\Claude\\claude_desktop_config.json` (Windows):\n\n```json\n{\n  \"mcpServers\": {\n    \"companybelgium\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@companybelgium/mcp-server\"],\n      \"env\": {\n        \"COMPANYBELGIUM_API_KEY\": \"pk_live_...\",\n        \"COMPANYBELGIUM_API_SECRET\": \"sk_live_...\"\n      }\n    }\n  }\n}\n```\n\nRestart Claude Desktop. The 6 tools will appear in the tools menu.\n\n## Configure Claude Code\n\nAdd to your project's `.mcp.json` or run:\n\n```bash\nclaude mcp add companybelgium \\\n  -e COMPANYBELGIUM_API_KEY=pk_live_... \\\n  -e COMPANYBELGIUM_API_SECRET=sk_live_... \\\n  -- npx -y @companybelgium/mcp-server\n```\n\n## Environment variables\n\n| Variable | Required | Default | Description |\n| --- | --- | --- | --- |\n| `COMPANYBELGIUM_API_KEY` | yes (external) | — | Public key `pk_live_...` |\n| `COMPANYBELGIUM_API_SECRET` | yes (external) | — | Secret key `sk_live_...` |\n| `COMPANYBELGIUM_API_URL` | no | `https://companybelgium.be` | Override for self-hosted / staging |\n\n## Quotas & billing\n\nEach tool call hits the public API with your `pk/sk` headers. Limits apply per your subscription tier:\n\n- **Free** — limited monthly quota, ideal for testing\n- **Starter / Pro / Enterprise** — see <https://companybelgium.be/pricing>\n\nWhen you hit the quota or rate limit, the tool returns a clear error like *\"Plan quota exhausted on the Starter plan. Upgrade at https://companybelgium.be/pricing.\"* — Claude will show this in the conversation.\n\n## Development\n\n```bash\npnpm install\npnpm --filter @companybelgium/mcp-server build\npnpm --filter @companybelgium/mcp-server dev\n```\n\nTo test the server locally, point Claude Desktop at the local build:\n\n```json\n{\n  \"mcpServers\": {\n    \"companybelgium-dev\": {\n      \"command\": \"node\",\n      \"args\": [\"/absolute/path/to/packages/mcp-server/dist/index.js\"],\n      \"env\": {\n        \"COMPANYBELGIUM_API_URL\": \"http://localhost:3002\",\n        \"COMPANYBELGIUM_API_KEY\": \"pk_live_...\",\n        \"COMPANYBELGIUM_API_SECRET\": \"sk_live_...\"\n      }\n    }\n  }\n}\n```\n\n## License\n\nMIT © Espero-Soft Informatiques SRL\n","readmeFilename":"README.md","_rev":"1-f8a8499f6a0a5b50200ffa6ede9d9520"}