# Brreg MCP Server — Norwegian Company Search for AI Agents (`longanimous_bracken/brreg-norway-company-search`) Actor Search Norwegian companies from the Brønnøysundregistrene (Brreg) open data API. Find org numbers, company names, addresses, company forms, registration status, and employee counts. AI-agent ready for KYC, B2B lead generation, and Norwegian market analysis. - **URL**: https://apify.com/longanimous\_bracken/brreg-norway-company-search.md - **Developed by:** [petteri mähönen](https://apify.com/longanimous_bracken) (community) - **Categories:** Lead generation, Business, MCP servers - **Stats:** 1 total users, 0 monthly users, 0.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing from $1.50 / 1,000 results This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event ## What's an Apify Actor? Actors are web data automations that power AI and operations. They run on the Apify platform to scrape websites, process data, connect APIs, and automate workflows. In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours, and optionally produces a well-defined JSON output, datasets with results, or files in key-value store. In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server. Actors are written with capital "A". ## How to integrate an Actor? If asked about integration, you help developers integrate Actors into their projects. You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready. The best way to integrate Actors is as follows. In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js/docs.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python/docs.md): ```bash pip install apify-client ``` In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md): ````bash # MacOS / Linux curl -fsSL https://apify.com/install-cli.sh | bash # Windows irm https://apify.com/install-cli.ps1 | iex ```bash In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/integrations/mcp.md). If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md). For usage examples, see the [API](#api) section below. For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt). # README ## Brreg MCP Server — Norwegian Company Search for AI Agents Search **Norwegian companies** from the Brønnøysundregistrene (Brreg) open data API. Retrieve org numbers (organisasjonsnummer), company names, addresses, legal forms, employee counts, and registration status. No browser, no proxies — pure REST API. ### 🧠 MCP Server — AI Agent Ready This actor is a **Model Context Protocol (MCP) server** — AI assistants (Claude, GPT, Cursor) can call it directly: ```json {"searchQuery": "Equinor", "maxResults": 5} ```` Returns structured Norwegian company data with org numbers, addresses, and employee information. ### Features - **Search by name** — partial name search across all registered entities - **Search by org number** — exact 9-digit organisasjonsnummer lookup - **Filter by municipality** — narrow results to a specific municipality (e.g., Oslo 0301) - **Filter by company form** — AS (aksjeselskap), ASA, ENK, NUF, etc. - **Employee counts** — get number of employees for each company - **Status tracking** — bankruptcy, liquidation, and deregistration status - **Free open data** — no API key, no rate limits - **Ultra cheap** — 256MB RAM, no browser overhead ### Input | Parameter | Type | Default | Description | |-----------|------|---------|-------------| | `searchQuery` | string | — | Company name or partial name to search | | `orgNumber` | string | — | Exact 9-digit Norwegian org number (e.g. `929990641`) | | `municipality` | string | — | 4-digit municipality code (0301=Oslo, 4601=Bergen) | | `companyForm` | string | — | Company form code (AS, ASA, ENK, NUF, FLI, etc.) | | `maxResults` | integer | 10 | Maximum results (max 500) | At least one search parameter is required. ### Output | Field | Type | Description | |-------|------|-------------| | `orgNumber` | string | 9-digit Norwegian organisasjonsnummer | | `name` | string | Registered company name | | `companyForm` | string | Legal form description (e.g. "Aksjeselskap") | | `companyFormCode` | string | Legal form code (e.g. "AS") | | `registrationDate` | string | Date of foundation or registration | | `norwegianBusinessAddress` | object | Street, post code, city, municipality | | `postalAddress` | object | Postal address | | `numberEmployees` | integer | Number of employees | | `phone`, `email`, `website` | string | Contact information | | `hasBankruptcies` | boolean | Whether the company has been through bankruptcy | | `underLiquidation` | boolean | Whether the company is under liquidation | | `scrapedAt` | string | ISO timestamp of the query | ### Example **Input:** ```json { "searchQuery": "Equinor", "maxResults": 3 } ``` **Output:** ```json [ { "orgNumber": "923609016", "name": "Equinor ASA", "companyForm": "Allmennaksjeselskap", "companyFormCode": "ASA", "registrationDate": "1972-09-18", "norwegianBusinessAddress": { "address": "Forusbeen 50", "city": "STAVANGER", "postCode": "4035" }, "numberEmployees": 23000 } ] ``` ### Data Source [Brreg Open Data API](https://data.brreg.no/enhetsregisteret/api/enheter) — free, no API key required. Data from the Brønnøysundregistrene (Brreg), the Norwegian government agency for company registration. ### Performance - **Memory**: 256 MB - **Runtime**: <1 second for most queries - **Cost**: ~$0.001 per run (10 results) - **Rate limit**: None detected (free public API) # Actor input Schema ## `searchQuery` (type: `string`): MCP tool input: company name or partial name to search. Norwegian characters (æøå) supported. Examples: 'Yara', 'Equinor', 'Telenor', 'DNB'. ## `orgNumber` (type: `string`): MCP tool input: exact Norwegian org number (9 digits). If provided, other search parameters are ignored. Example: '929990641'. ## `municipality` (type: `string`): MCP tool input: 4-digit municipality code. Examples: '0301' (Oslo), '4601' (Bergen), '5001' (Trondheim). ## `companyForm` (type: `string`): MCP tool input: filter by organizational form code. Examples: 'AS' (aksjeselskap), 'ASA' (allmennaksjeselskap), 'ENK' (enkeltpersonforetak), 'NUF' (foreign company), 'FLI' (forening/lag/innretning). ## `maxResults` (type: `integer`): MCP tool input: maximum companies to return. Recommended: 10-20 for AI agent consumption. Max: 500. ## Actor input object example ```json { "maxResults": 10 } ``` # API You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup. ## JavaScript example ```javascript import { ApifyClient } from 'apify-client'; // Initialize the ApifyClient with your Apify API token // Replace the '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = { "searchQuery": "", "orgNumber": "", "municipality": "", "companyForm": "" }; // Run the Actor and wait for it to finish const run = await client.actor("longanimous_bracken/brreg-norway-company-search").call(input); // Fetch and print Actor results from the run's dataset (if any) console.log('Results from dataset'); console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`); const { items } = await client.dataset(run.defaultDatasetId).listItems(); items.forEach((item) => { console.dir(item); }); // 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs ``` ## Python example ```python from apify_client import ApifyClient # Initialize the ApifyClient with your Apify API token # Replace '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = { "searchQuery": "", "orgNumber": "", "municipality": "", "companyForm": "", } # Run the Actor and wait for it to finish run = client.actor("longanimous_bracken/brreg-norway-company-search").call(run_input=run_input) # Fetch and print Actor results from the run's dataset (if there are any) print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"]) for item in client.dataset(run["defaultDatasetId"]).iterate_items(): print(item) # 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start ``` ## CLI example ```bash echo '{ "searchQuery": "", "orgNumber": "", "municipality": "", "companyForm": "" }' | apify call longanimous_bracken/brreg-norway-company-search --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=longanimous_bracken/brreg-norway-company-search", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Brreg MCP Server — Norwegian Company Search for AI Agents", "description": "Search Norwegian companies from the Brønnøysundregistrene (Brreg) open data API. Find org numbers, company names, addresses, company forms, registration status, and employee counts. AI-agent ready for KYC, B2B lead generation, and Norwegian market analysis.", "version": "0.1", "x-build-id": "gzJFcc5J1YlPwzTPn" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/longanimous_bracken~brreg-norway-company-search/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-longanimous_bracken-brreg-norway-company-search", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } }, "/acts/longanimous_bracken~brreg-norway-company-search/runs": { "post": { "operationId": "runs-sync-longanimous_bracken-brreg-norway-company-search", "x-openai-isConsequential": false, "summary": "Executes an Actor and returns information about the initiated run in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/runsResponseSchema" } } } } } } }, "/acts/longanimous_bracken~brreg-norway-company-search/run-sync": { "post": { "operationId": "run-sync-longanimous_bracken-brreg-norway-company-search", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } } }, "components": { "schemas": { "inputSchema": { "type": "object", "properties": { "searchQuery": { "title": "Company Name", "type": "string", "description": "MCP tool input: company name or partial name to search. Norwegian characters (æøå) supported. Examples: 'Yara', 'Equinor', 'Telenor', 'DNB'." }, "orgNumber": { "title": "Organisasjonsnummer", "pattern": "^\\d{9}$", "type": "string", "description": "MCP tool input: exact Norwegian org number (9 digits). If provided, other search parameters are ignored. Example: '929990641'." }, "municipality": { "title": "Municipality Code (Kommunenummer)", "type": "string", "description": "MCP tool input: 4-digit municipality code. Examples: '0301' (Oslo), '4601' (Bergen), '5001' (Trondheim)." }, "companyForm": { "title": "Company Form", "type": "string", "description": "MCP tool input: filter by organizational form code. Examples: 'AS' (aksjeselskap), 'ASA' (allmennaksjeselskap), 'ENK' (enkeltpersonforetak), 'NUF' (foreign company), 'FLI' (forening/lag/innretning)." }, "maxResults": { "title": "Max Results", "type": "integer", "description": "MCP tool input: maximum companies to return. Recommended: 10-20 for AI agent consumption. Max: 500.", "default": 10 } } }, "runsResponseSchema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "actId": { "type": "string" }, "userId": { "type": "string" }, "startedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "finishedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "status": { "type": "string", "example": "READY" }, "meta": { "type": "object", "properties": { "origin": { "type": "string", "example": "API" }, "userAgent": { "type": "string" } } }, "stats": { "type": "object", "properties": { "inputBodyLen": { "type": "integer", "example": 2000 }, "rebootCount": { "type": "integer", "example": 0 }, "restartCount": { "type": "integer", "example": 0 }, "resurrectCount": { "type": "integer", "example": 0 }, "computeUnits": { "type": "integer", "example": 0 } } }, "options": { "type": "object", "properties": { "build": { "type": "string", "example": "latest" }, "timeoutSecs": { "type": "integer", "example": 300 }, "memoryMbytes": { "type": "integer", "example": 1024 }, "diskMbytes": { "type": "integer", "example": 2048 } } }, "buildId": { "type": "string" }, "defaultKeyValueStoreId": { "type": "string" }, "defaultDatasetId": { "type": "string" }, "defaultRequestQueueId": { "type": "string" }, "buildNumber": { "type": "string", "example": "1.0.0" }, "containerUrl": { "type": "string" }, "usage": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "integer", "example": 1 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } }, "usageTotalUsd": { "type": "number", "example": 0.00005 }, "usageUsd": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "number", "example": 0.00005 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } } } } } } } } } ```