brreg

This MCP server provides a structured interface to the Brønnøysundregistrene (Brreg) API, exposing a suite of tools that allow you to search and retrieve data about Norwegian companies, subunits, organization forms, municipalities, and more. Core capabilities include searching for companies with filters such as name, organization number, industry codes (NACE), location, and employee counts; fetching detailed information about specific companies or subunits; retrieving company and subunit updates; and exploring organizational forms, municipalities, and NACE codes. The provided MCP tools are designed to be type-safe and cover common use cases, from basic lookups to hierarchical NACE code exploration. Use the search_companies tool to discover entities, get_company/get_subunit for in-depth details, and get_municipalities or get_organization_forms for reference data. The update endpoints help you track changes over time, and the NACE search supports hierarchical filtering to drill into classifications.

To use the tools, call them with the appropriate arguments as shown in the examples in the README. For instance, search_companies can filter by industryCode, municipalityNumber, and employee ranges; get_company requires a 9-digit organizationNumber; and get_municipalities supports pagination and sorting. The server also includes dedicated endpoints for organization forms, municipalities, role information, and update streams, enabling you to build rich data integrations or monitoring dashboards on top of Brreg data.

Prerequisites:

• Node.js and npm installed on your system
• Basic command-line knowledge

Option 1: Install from npm (Recommended)

# Install globally
npm install -g brreg-mcp-server

# Or install locally in your project
npm install brreg-mcp-server

Option 2: Clone from source

# Clone repository
git clone https://github.com/david/brreg-mcp-server.git
cd brreg-mcp-server

# Install dependencies
npm install

# Build project
npm run build

# Start server
npm start

Development mode (optional)

# Run in development mode
npm run dev

Notes and tips:

• The MCP server is designed to be used with the brreg-mcp-server package; ensure you’re using a compatible Node.js version as specified by the project.
• If you’re behind a proxy or require API keys for Brreg, set BRREG_API_BASE_URL and BRREG_API_KEY in the environment or via your deployment configuration.
• Use the pagination options (page, size) for endpoints that return lists to control payload size.
• For NACE code searches, leverage the hierarchical filtering to progressively narrow results (level, parentCode, includeHierarchy).
• If you encounter rate limits or authentication issues, check your API access configuration and consider implementing caching on the client side.
• Typical issues include network connectivity, invalid parameters, or missing required fields (e.g., organizationNumber for get_company/get_subunit).
• This server provides TypeScript typings; ensure your consuming application is aligned with the provided types for safer integration.