search_entities
Find Norwegian business entities using filters like name, organization number, industry codes, or registration status to access company information from the national registry.
Instructions
Search for Norwegian business entities (hovedenheter) with various filters
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| navn | No | Entity name (1-180 characters) | |
| navnMetodeForSoek | No | Search method for name parameter | |
| organisasjonsnummer | No | List of organization numbers (9 digits) | |
| overordnetEnhet | No | Parent entity organization number | |
| fraAntallAnsatte | No | Minimum number of employees | |
| tilAntallAnsatte | No | Maximum number of employees | |
| konkurs | No | Whether entity is bankrupt | |
| registrertIMvaregisteret | No | Registered in VAT registry | |
| registrertIForetaksregisteret | No | Registered in business registry | |
| registrertIStiftelsesregisteret | No | Registered in foundation registry | |
| registrertIFrivillighetsregisteret | No | Registered in voluntary organization registry | |
| underTvangsavviklingEllerTvangsopplosning | No | Under forced liquidation | |
| underAvvikling | No | Under liquidation | |
| underKonkursbehandling | No | Under bankruptcy proceedings | |
| organisasjonsform | No | Organizational forms | |
| hjemmeside | No | Website | |
| kommunenummer | No | Municipality numbers | |
| naeringskode | No | Industry codes | |
| size | No | Page size (default 20) | |
| page | No | Page number | |
| sort | No | Sort field and order (e.g., 'navn,ASC') |
Implementation Reference
- src/brreg-mcp-server.ts:402-411 (handler)The main MCP tool handler logic for 'search_entities'. It extracts parameters, calls the BrregApiClient's searchEntities method, and returns the results as a formatted JSON text content block.
case "search_entities": const entityResults = await apiClient.searchEntities(request.params.arguments as EntitySearchParams); return { content: [ { type: "text", text: JSON.stringify(entityResults, null, 2), }, ], }; - src/brreg-mcp-server.ts:14-36 (schema)TypeScript interface defining the input parameters for the search_entities tool, matching the MCP inputSchema.
interface EntitySearchParams { navn?: string; navnMetodeForSoek?: string; organisasjonsnummer?: string[]; overordnetEnhet?: string; fraAntallAnsatte?: number; tilAntallAnsatte?: number; konkurs?: boolean; registrertIMvaregisteret?: boolean; registrertIForetaksregisteret?: boolean; registrertIStiftelsesregisteret?: boolean; registrertIFrivillighetsregisteret?: boolean; underTvangsavviklingEllerTvangsopplosning?: boolean; underAvvikling?: boolean; underKonkursbehandling?: boolean; organisasjonsform?: string[]; hjemmeside?: string; kommunenummer?: string[]; naeringskode?: string[]; size?: number; page?: number; sort?: string; } - src/brreg-mcp-server.ts:184-208 (schema)MCP input schema definition for the search_entities tool, as returned by ListTools.
type: "object", properties: { navn: { type: "string", description: "Entity name (1-180 characters)" }, navnMetodeForSoek: { type: "string", enum: ["FORTLOEPENDE"], description: "Search method for name parameter" }, organisasjonsnummer: { type: "array", items: { type: "string" }, description: "List of organization numbers (9 digits)" }, overordnetEnhet: { type: "string", description: "Parent entity organization number" }, fraAntallAnsatte: { type: "number", description: "Minimum number of employees" }, tilAntallAnsatte: { type: "number", description: "Maximum number of employees" }, konkurs: { type: "boolean", description: "Whether entity is bankrupt" }, registrertIMvaregisteret: { type: "boolean", description: "Registered in VAT registry" }, registrertIForetaksregisteret: { type: "boolean", description: "Registered in business registry" }, registrertIStiftelsesregisteret: { type: "boolean", description: "Registered in foundation registry" }, registrertIFrivillighetsregisteret: { type: "boolean", description: "Registered in voluntary organization registry" }, underTvangsavviklingEllerTvangsopplosning: { type: "boolean", description: "Under forced liquidation" }, underAvvikling: { type: "boolean", description: "Under liquidation" }, underKonkursbehandling: { type: "boolean", description: "Under bankruptcy proceedings" }, organisasjonsform: { type: "array", items: { type: "string" }, description: "Organizational forms" }, hjemmeside: { type: "string", description: "Website" }, kommunenummer: { type: "array", items: { type: "string" }, description: "Municipality numbers" }, naeringskode: { type: "array", items: { type: "string" }, description: "Industry codes" }, size: { type: "number", description: "Page size (default 20)" }, page: { type: "number", description: "Page number" }, sort: { type: "string", description: "Sort field and order (e.g., 'navn,ASC')" } } } - src/brreg-mcp-server.ts:180-210 (registration)Tool registration in the ListTools response, defining name, description, and input schema.
{ name: "search_entities", description: "Search for Norwegian business entities (hovedenheter) with various filters", inputSchema: { type: "object", properties: { navn: { type: "string", description: "Entity name (1-180 characters)" }, navnMetodeForSoek: { type: "string", enum: ["FORTLOEPENDE"], description: "Search method for name parameter" }, organisasjonsnummer: { type: "array", items: { type: "string" }, description: "List of organization numbers (9 digits)" }, overordnetEnhet: { type: "string", description: "Parent entity organization number" }, fraAntallAnsatte: { type: "number", description: "Minimum number of employees" }, tilAntallAnsatte: { type: "number", description: "Maximum number of employees" }, konkurs: { type: "boolean", description: "Whether entity is bankrupt" }, registrertIMvaregisteret: { type: "boolean", description: "Registered in VAT registry" }, registrertIForetaksregisteret: { type: "boolean", description: "Registered in business registry" }, registrertIStiftelsesregisteret: { type: "boolean", description: "Registered in foundation registry" }, registrertIFrivillighetsregisteret: { type: "boolean", description: "Registered in voluntary organization registry" }, underTvangsavviklingEllerTvangsopplosning: { type: "boolean", description: "Under forced liquidation" }, underAvvikling: { type: "boolean", description: "Under liquidation" }, underKonkursbehandling: { type: "boolean", description: "Under bankruptcy proceedings" }, organisasjonsform: { type: "array", items: { type: "string" }, description: "Organizational forms" }, hjemmeside: { type: "string", description: "Website" }, kommunenummer: { type: "array", items: { type: "string" }, description: "Municipality numbers" }, naeringskode: { type: "array", items: { type: "string" }, description: "Industry codes" }, size: { type: "number", description: "Page size (default 20)" }, page: { type: "number", description: "Page number" }, sort: { type: "string", description: "Sort field and order (e.g., 'navn,ASC')" } } } }, { - src/brreg-mcp-server.ts:79-81 (helper)Helper method in BrregApiClient that performs the actual API request to search entities using makeRequest.
async searchEntities(params: EntitySearchParams = {}) { return this.makeRequest('/enhetsregisteret/api/enheter', params); }