Tutorial: Nordic Registry

Business

Data source: Brønnøysundregistrene, Bolagsverket, PRH, CVR

Overview

Nordic Registry searches across 4 data sources (Brønnøysundregistrene, Bolagsverket, PRH, CVR) in a single query. It deduplicates and normalizes results, saving you from building 4 separate integrations. This tutorial walks through all 4 tools with working code examples.

Prerequisites

Sign up at https://context.gnist.ai/signup for a free API key (100 calls/day).
Choose your integration method: MCP protocol or REST API.

Connect via MCP

Add to your MCP client config (Claude Desktop, Cursor, etc.):

MCP Config

{
  "mcpServers": {
    "gnist-nordic-registry": {
      "url": "https://context.gnist.ai/mcp/nordic-registry/",
      "headers": {
        "Gnist-API-Key": "YOUR_API_KEY"
      }
    }
  }
}

Tools (4)

`search_nordic_companies`

Search for companies across all Nordic registries in parallel. Queries Norway (Brønnøysundregistrene), Sweden (Bolagsverket), Finland (PRH), and Denmark (CVR) simultaneously. Returns unified company records with name, national ID, status, legal form, industry, address, and source registry. Examples: search_nordic_companies(query="Equinor") search_nordic_companies(query="Volvo", country="SE") search_nordic_companies(query="Nokia", country="FI", limit=5)

Parameter	Type	Required	Description
`query`	string	required	Company name to search.
`country`	any	optional	Filter: 'NO' (Norway), 'SE' (Sweden), 'FI' (Finland), 'DK' (Denmark). Omit for all.
`limit`	integer	optional	Max results per registry. (default: `10`)

curl -X POST "https://context.gnist.ai/mcp/nordic-registry/" \
  -H "Content-Type: application/json" \
  -H "Gnist-API-Key: YOUR_API_KEY" \
  -d '{"jsonrpc": "2.0", "method": "tools/call", "id": 1, "params": {"name": "search_nordic_companies", "arguments": {"query": "renewable energy"}}}'

import httpx

resp = httpx.post(
    "https://context.gnist.ai/mcp/nordic-registry/",
    headers={"Gnist-API-Key": "YOUR_API_KEY"},
    json={'id': 1,
 'jsonrpc': '2.0',
 'method': 'tools/call',
 'params': {'arguments': {'query': 'renewable energy'},
            'name': 'search_nordic_companies'}},
)
print(resp.json())

`lookup_nordic_company`

Look up a specific company by national ID across Nordic registries. Automatically detects the country from the ID format and queries the correct registry. Returns a unified company record. ID formats: - Norway: 9 digits (e.g. 923609016) - Sweden: 10 digits with optional dash (e.g. 556000-4615) - Finland: 7+1 digits with dash (e.g. 0112038-9) - Denmark: 8 digits (e.g. 10150817) Examples: lookup_nordic_company(national_id="923609016") # Equinor (Norway) lookup_nordic_company(national_id="556000-4615") # Volvo (Sweden) lookup_nordic_company(national_id="0112038-9") # Nokia (Finland)

Parameter	Type	Required	Description
`national_id`	string	required	National business ID. Auto-detected: 9 digits (NO), XXXXXX-XXXX (SE), XXXXXXX-X (FI), 8 digits (DK).

curl -X POST "https://context.gnist.ai/mcp/nordic-registry/" \
  -H "Content-Type: application/json" \
  -H "Gnist-API-Key: YOUR_API_KEY" \
  -d '{"jsonrpc": "2.0", "method": "tools/call", "id": 1, "params": {"name": "lookup_nordic_company", "arguments": {"national_id": "12345"}}}'

import httpx

resp = httpx.post(
    "https://context.gnist.ai/mcp/nordic-registry/",
    headers={"Gnist-API-Key": "YOUR_API_KEY"},
    json={'id': 1,
 'jsonrpc': '2.0',
 'method': 'tools/call',
 'params': {'arguments': {'national_id': '12345'},
            'name': 'lookup_nordic_company'}},
)
print(resp.json())

`list_nordic_registry_sources`

List all Nordic company registry sources and their coverage. Shows which registries are available and their country coverage. Examples: list_nordic_registry_sources()

curl -X POST "https://context.gnist.ai/mcp/nordic-registry/" \
  -H "Content-Type: application/json" \
  -H "Gnist-API-Key: YOUR_API_KEY" \
  -d '{"jsonrpc": "2.0", "method": "tools/call", "id": 1, "params": {"name": "list_nordic_registry_sources", "arguments": {}}}'

import httpx

resp = httpx.post(
    "https://context.gnist.ai/mcp/nordic-registry/",
    headers={"Gnist-API-Key": "YOUR_API_KEY"},
    json={'id': 1,
 'jsonrpc': '2.0',
 'method': 'tools/call',
 'params': {'arguments': {}, 'name': 'list_nordic_registry_sources'}},
)
print(resp.json())

`report_feedback`

Report a bug, feature request, or general feedback for this data source. Use this when something doesn't work as expected, when you'd like a new feature, or when you have suggestions for improvement. Args: feedback: Describe the issue or suggestion. feedback_type: One of 'bug', 'feature_request', or 'general'.

Parameter	Type	Required	Description
`feedback`	string	required
`feedback_type`	string	optional	(default: `general`)

curl -X POST "https://context.gnist.ai/mcp/nordic-registry/" \
  -H "Content-Type: application/json" \
  -H "Gnist-API-Key: YOUR_API_KEY" \
  -d '{"jsonrpc": "2.0", "method": "tools/call", "id": 1, "params": {"name": "report_feedback", "arguments": {"feedback": "example"}}}'

import httpx

resp = httpx.post(
    "https://context.gnist.ai/mcp/nordic-registry/",
    headers={"Gnist-API-Key": "YOUR_API_KEY"},
    json={'id': 1,
 'jsonrpc': '2.0',
 'method': 'tools/call',
 'params': {'arguments': {'feedback': 'example'}, 'name': 'report_feedback'}},
)
print(resp.json())

Common Patterns

Search then retrieve
Use search_nordic_companies to find items, then lookup_nordic_company to get full details. This two-step pattern is common for exploring data before drilling down.

Pagination
Several tools support limit, offset, or page parameters. Start with small limits during development, then increase for production queries.

FAQ

What data does Nordic Registry provide?

Pan-Nordic company lookup across Norway, Sweden, Finland, and Denmark — search by name or look up by national ID with automatic country detection. It exposes 4 tools: search_nordic_companies, lookup_nordic_company, list_nordic_registry_sources, report_feedback.

What do I need to get started?

A Gnist API key (free tier: 100 calls/day). Sign up at https://context.gnist.ai/signup.

What format does the Nordic Registry API return?

JSON, via either MCP protocol (JSON-RPC 2.0) or REST API.

Which data sources does Nordic Registry aggregate?

Brønnøysundregistrene, Bolagsverket, PRH, CVR. Results are deduplicated and normalized into a consistent format.