search_sub_entities
Search for Norwegian business sub-entities using filters like name, organization number, employee count, registration dates, industry codes, and organizational forms to find specific subsidiary information.
Instructions
Search for Norwegian business sub-entities (underenheter) with various filters
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| fraAntallAnsatte | No | Minimum number of employees | |
| fraDatoEierskifte | No | Ownership change date from (ISO-8601 yyyy-MM-dd) | |
| fraNedleggelsesdato | No | Closure date from (ISO-8601 yyyy-MM-dd) | |
| fraOppstartsdato | No | Start date from (ISO-8601 yyyy-MM-dd) | |
| hjemmeside | No | Website | |
| kommunenummer | No | Municipality numbers | |
| naeringskode | No | Industry codes | |
| navn | No | Sub-entity name (1-180 characters) | |
| navnMetodeForSoek | No | Search method for name parameter | |
| organisasjonsform | No | Organizational forms | |
| organisasjonsnummer | No | List of organization numbers (9 digits) | |
| overordnetEnhet | No | Parent entity organization number | |
| page | No | Page number | |
| registrertIMvaregisteret | No | Registered in VAT registry | |
| size | No | Page size (default 20) | |
| sort | No | Sort field and order | |
| tilAntallAnsatte | No | Maximum number of employees | |
| tilDatoEierskifte | No | Ownership change date to (ISO-8601 yyyy-MM-dd) | |
| tilNedleggelsesdato | No | Closure date to (ISO-8601 yyyy-MM-dd) | |
| tilOppstartsdato | No | Start date to (ISO-8601 yyyy-MM-dd) |
Input Schema (JSON Schema)
{
"properties": {
"fraAntallAnsatte": {
"description": "Minimum number of employees",
"type": "number"
},
"fraDatoEierskifte": {
"description": "Ownership change date from (ISO-8601 yyyy-MM-dd)",
"type": "string"
},
"fraNedleggelsesdato": {
"description": "Closure date from (ISO-8601 yyyy-MM-dd)",
"type": "string"
},
"fraOppstartsdato": {
"description": "Start date from (ISO-8601 yyyy-MM-dd)",
"type": "string"
},
"hjemmeside": {
"description": "Website",
"type": "string"
},
"kommunenummer": {
"description": "Municipality numbers",
"items": {
"type": "string"
},
"type": "array"
},
"naeringskode": {
"description": "Industry codes",
"items": {
"type": "string"
},
"type": "array"
},
"navn": {
"description": "Sub-entity name (1-180 characters)",
"type": "string"
},
"navnMetodeForSoek": {
"description": "Search method for name parameter",
"enum": [
"FORTLOEPENDE"
],
"type": "string"
},
"organisasjonsform": {
"description": "Organizational forms",
"items": {
"type": "string"
},
"type": "array"
},
"organisasjonsnummer": {
"description": "List of organization numbers (9 digits)",
"items": {
"type": "string"
},
"type": "array"
},
"overordnetEnhet": {
"description": "Parent entity organization number",
"type": "string"
},
"page": {
"description": "Page number",
"type": "number"
},
"registrertIMvaregisteret": {
"description": "Registered in VAT registry",
"type": "boolean"
},
"size": {
"description": "Page size (default 20)",
"type": "number"
},
"sort": {
"description": "Sort field and order",
"type": "string"
},
"tilAntallAnsatte": {
"description": "Maximum number of employees",
"type": "number"
},
"tilDatoEierskifte": {
"description": "Ownership change date to (ISO-8601 yyyy-MM-dd)",
"type": "string"
},
"tilNedleggelsesdato": {
"description": "Closure date to (ISO-8601 yyyy-MM-dd)",
"type": "string"
},
"tilOppstartsdato": {
"description": "Start date to (ISO-8601 yyyy-MM-dd)",
"type": "string"
}
},
"type": "object"
}
Implementation Reference
- src/brreg-mcp-server.ts:91-93 (handler)Core handler function in BrregApiClient that performs the API request to search for Norwegian business sub-entities (underenheter).async searchSubEntities(params: SubEntitySearchParams = {}) { return this.makeRequest('/enhetsregisteret/api/underenheter', params); }
- src/brreg-mcp-server.ts:38-45 (schema)TypeScript interface defining the input parameters for the searchSubEntities tool, extending EntitySearchParams with additional date filters.interface SubEntitySearchParams extends Omit<EntitySearchParams, 'konkurs' | 'underTvangsavviklingEllerTvangsopplosning' | 'underAvvikling' | 'underKonkursbehandling'> { fraOppstartsdato?: string; tilOppstartsdato?: string; fraDatoEierskifte?: string; tilDatoEierskifte?: string; fraNedleggelsesdato?: string; tilNedleggelsesdato?: string; }
- src/brreg-mcp-server.ts:233-260 (registration)MCP tool registration including name, description, and detailed input JSON schema.name: "search_sub_entities", description: "Search for Norwegian business sub-entities (underenheter) with various filters", inputSchema: { type: "object", properties: { navn: { type: "string", description: "Sub-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" }, registrertIMvaregisteret: { type: "boolean", description: "Registered in VAT registry" }, fraOppstartsdato: { type: "string", description: "Start date from (ISO-8601 yyyy-MM-dd)" }, tilOppstartsdato: { type: "string", description: "Start date to (ISO-8601 yyyy-MM-dd)" }, fraDatoEierskifte: { type: "string", description: "Ownership change date from (ISO-8601 yyyy-MM-dd)" }, tilDatoEierskifte: { type: "string", description: "Ownership change date to (ISO-8601 yyyy-MM-dd)" }, fraNedleggelsesdato: { type: "string", description: "Closure date from (ISO-8601 yyyy-MM-dd)" }, tilNedleggelsesdato: { type: "string", description: "Closure date to (ISO-8601 yyyy-MM-dd)" }, 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" } } } },
- src/brreg-mcp-server.ts:437-446 (handler)MCP CallToolRequest handler case that invokes the searchSubEntities method and returns the JSON-formatted results.case "search_sub_entities": const subEntityResults = await apiClient.searchSubEntities(request.params.arguments as SubEntitySearchParams); return { content: [ { type: "text", text: JSON.stringify(subEntityResults, null, 2), }, ], };