Brreg MCP Server

A Model Context Protocol (MCP) server for interacting with Brønnøysundregistrene (Brreg) API - Norwegian Business Registry.

Features

• Company Search: Search for companies with various filters

• Company Details: Get detailed information about specific companies

• Company Roles: Retrieve roles and board members

• Subunit Search: Search for business units/subunits

• Subunit Details: Get detailed information about specific subunits

• Organization Forms: Get organization forms and their descriptions

• Municipalities: Get Norwegian municipalities and their details

• Role Information: Get role types, role group types, and representatives

• Updates Tracking: Get updates for companies and subunits

• NACE Codes: Search and filter by NACE industry codes with hierarchical support

• Error Handling: Comprehensive error handling with validation

• Type Safety: Full TypeScript support with proper type definitions

Installation

Option 1: Install from npm (Recommended)

Option 2: Clone from source

Development

MCP Tools

1. search_companies

Search for companies in Norwegian Business Registry.

Parameters:

• name (string): Company name (free text, 1-180 characters)

• organizationNumber (array): Organization numbers (9 digits each)

• parentCompany (string): Parent company organization number

• fromEmployees (number): Minimum number of employees

• toEmployees (number): Maximum number of employees

• bankrupt (boolean): Filter by bankruptcy status

• registeredInVAT (boolean): Filter by VAT registration

• registeredInBusinessRegister (boolean): Filter by business register status

• organizationForm (array): Organization forms (e.g., AS, ENK)

• municipalityNumber (array): Municipality numbers (4 digits each)

• industryCode (array): Industry codes (e.g., 41.109, 01.1)

• page (number): Page number (default: 1)

• size (number): Page size (default: 20)

• sort (string): Sort field and order (e.g., antallAnsatte,ASC)

2. get_company

Get detailed information about a specific company.

Parameters:

• organizationNumber (string, required): Organization number (9 digits)

3. get_company_roles

Get all roles for a specific company.

Parameters:

• organizationNumber (string, required): Organization number (9 digits)

4. search_subunits

Search for business units/subunits.

Parameters:

• name (string): Subunit name

• organizationNumber (array): Organization numbers

• parentCompany (string): Parent company

• fromEmployees (number): Minimum employees

• toEmployees (number): Maximum employees

• registeredInVAT (boolean): VAT registration status

• page (number): Page number

• size (number): Page size

5. get_subunit

Get detailed information about a specific subunit.

Parameters:

• organizationNumber (string, required): Organization number (9 digits)

6. get_organization_forms

Get all organization forms.

Parameters:

• page (number): Page number (default: 1)

• size (number): Page size (default: 20)

• sort (string): Sort field and order (e.g., kode,ASC)

7. get_organization_forms_for_units

Get organization forms for main units.

Parameters:

• page (number): Page number (default: 1)

• size (number): Page size (default: 20)

• sort (string): Sort field and order (e.g., kode,ASC)

8. get_organization_forms_for_subunits

Get organization forms for subunits.

Parameters:

• page (number): Page number (default: 1)

• size (number): Page size (default: 20)

• sort (string): Sort field and order (e.g., kode,ASC)

9. get_organization_form

Get specific organization form by code.

Parameters:

• organizationCode (string, required): Organization form code (e.g., AS, ENK, ASA)

10. get_municipalities

Get all Norwegian municipalities.

Parameters:

• page (number): Page number (default: 1)

• size (number): Page size (default: 20)

• sort (string): Sort field and order (e.g., navn,ASC)

11. get_municipality

Get specific municipality by municipality number.

Parameters:

• municipalityNumber (string, required): Municipality number (4 digits)

12. get_role_types

Get all role types.

13. get_role_group_types

Get all role group types.

14. get_role_representatives

Get all role representatives.

15. get_company_updates

Get updates for companies with optional filters.

Parameters:

• date (string): Show updates from and including this timestamp (ISO-8601)

• updatedBefore (string): Show updates to and including this timestamp (ISO-8601)

• updateId (number): Show only updates from and including update ID (>= 1)

• organizationNumber (array): Comma-separated list of organization numbers

• includeChanges (boolean): Include the changes that caused the update to be published

• page (number): Page number (default: 1)

• size (number): Page size (default: 20, max: 10000)

• sort (string): Sort field and order (e.g., id,ASC). Only id is supported

16. get_subunit_updates

Get updates for subunits with optional filters.

Parameters:

• date (string): Show updates from and including this timestamp (ISO-8601)

• updatedBefore (string): Show updates to and including this timestamp (ISO-8601)

• updateId (number): Show only updates from and including update ID (>= 1)

• organizationNumber (array): Comma-separated list of organization numbers

• includeChanges (boolean): Include the changes that caused the update to be published

• page (number): Page number (default: 1)

• size (number): Page size (default: 20, max: 10000)

• sort (string): Sort field and order (e.g., id,ASC). Only id is supported

17. search_nace_codes

Search NACE industry codes with hierarchical filtering support using the full SN2025 classification.

Parameters:

• searchText (string): Text to search for in NACE code names, short names, codes, or notes

• parentCode (string): Get all child codes for a specific NACE parent code (e.g., "01.1" will return all subcategories)

• exactCode (string): Get specific NACE code by exact code

• level (string): Filter by NACE level (1-5). Level 1 = sections, Level 2 = divisions, Level 3 = groups, Level 4 = classes, Level 5 = national subcategories

• includeHierarchy (boolean): Include full hierarchical path in results (default: true)

• includeNotes (boolean): Include detailed notes in results (default: false)

18. get_services

Get all available services from Brreg API.

Usage Examples

Search for software companies in Oslo

Get company details

Get subunit details

Get organization forms

Get specific organization form

Get municipalities

Get company updates

Search NACE codes

Get NACE codes by parent

Configuration

Claude Desktop Setup

Add this to your claude_desktop_config.json:

Or if installed globally:

Error Handling

The server provides comprehensive error handling:

• Validation Errors: Invalid input parameters

• Not Found Errors: Company or resource not found

• Rate Limit Errors: API rate limits exceeded

• Server Errors: Temporary server issues

• Network Errors: Connection problems

Data Types

The server provides proper TypeScript types for:

• Company information

• Subunit data

• Role information

• API responses

• Error responses

License

MIT License

Contributing

1. Fork the repository

2. Create a feature branch

3. Make your changes

4. Add tests

5. Submit a pull request

Support

For issues related to the Brreg API itself, visit Brreg's documentation.

For issues with this MCP server, please create an issue in the repository.