brreg-mcp

# brreg-mcp MCP server for the Norwegian Central Coordinating Register for Legal Entities (Brønnøysundregistrene / Enhetsregisteret). Gives Claude Code and other MCP-compatible clients direct access to Norwegian company data — lookup, search, roles, subunits, and live updates. No API key needed. Data is served by the free, public Brønnøysund Open Data API. ## Why Norwegian devs, accountants, and analysts constantly need to look up orgnumbers, find board members, or track subsidiary changes. Doing it through the web UI is slow; doing it with `curl` loses context. With this MCP, you just ask Claude. ## Install ### Claude Code Add to your MCP config (`~/.claude/settings.json` or per-project `.claude/settings.json`): ```json { "mcpServers": { "brreg": { "command": "npx", "args": ["-y", "brreg-mcp"] } } } ``` Restart Claude Code. Verify with `/mcp` — you should see `brreg` listed with 5 tools. ### Claude Desktop `claude_desktop_config.json`: ```json { "mcpServers": { "brreg": { "command": "npx", "args": ["-y", "brreg-mcp"] } } } ``` ### Cursor / Windsurf / Zed / any MCP client Same `command: npx`, `args: ["-y", "brreg-mcp"]` configuration. ### Local development ```bash git clone https://github.com/hellosverre/brreg-mcp cd brreg-mcp npm install npm run build ``` Then point your MCP client at `node /absolute/path/to/brreg-mcp/dist/index.js`. ## Tools | Tool | What it does | | --- | --- | | `lookup_company` | Full details for one company by its 9-digit orgnr — name, address, NACE codes, employees, VAT status, bankruptcy, foundation date. | | `search_companies` | Search by name and optional filters (municipality, org form, industry code, VAT-registered, bankruptcy status). Paginated. | | `get_company_roles` | All registered roles (board, CEO, chair, auditor, sole proprietor) for a company. | | `search_subunits` | Find subunits (branch offices, production sites) — scope to a parent company or by municipality/industry. | | `get_recent_updates` | Feed of entity changes for monitoring new registrations, bankruptcies, status shifts. | ## Example prompts > "Look up orgnr 984661177 and show me the board." > "Find all VAT-registered software consultancies (NACE 62.010) in Oslo." > "List every subunit of Vygruppen AS." > "What Norwegian companies were just registered in the last hour?" ## Data source All data comes from [data.brreg.no](https://data.brreg.no/enhetsregisteret/api/dokumentasjon/en/index.html). Per Brønnøysund's open data terms, the data is free to use. Some endpoints (roles with personal identification numbers) require Maskinporten authentication and are not exposed by this server. ## Development ```bash npm install # install deps npm run dev # run server in watch mode via tsx npm run smoke # hit the real brreg API to verify connectivity npm run build # compile to dist/ npx tsx scripts/mcp-probe.ts # end-to-end stdio test ``` ## License MIT ## Disclaimer Not affiliated with Brønnøysundregistrene or the Norwegian government. This is an independent open-source project using the public open-data API.