🏢 CompanyIQ MCP Server

Norwegian Company Intelligence Platform powered by MCP. Provides comprehensive business intelligence, market analysis, and competitive insights using data from Brønnøysund and SSB (Statistics Norway).

Features

• 🔍 Company Search: Find companies by industry, size, location

• 📈 Growth Analysis: Identify high-growth companies with SSB benchmarks

• 👥 Ownership Mapping: Analyze ownership structures

• 👔 Board Tracking: Track board composition and leadership

• 💰 Financial Analysis: AUTOMATIC FETCH from Regnskapsregisteret API - NO manual download! 🚀

• 🏭 Market Landscape: Competitive landscape analysis with SSB industry statistics

• 🔄 Consolidation Trends: M&A and market concentration analysis with SSB data

• 📊 Economic Context: Macro-economic statistics and industry trends from SSB

• 🤖 Auto-Fetch Financials: Automatically download financial statements from Brønnøysund API (2018+)

• 🤖 Auto-Scrape ALL Years: Headless browser automation downloads and parses ALL historical PDFs (60s)

• 📥 Manual Data Import: Import financial data from CSV/JSON files (fallback/bulk)

• 🔍 Universal Search: Search ANY Norwegian company by name - full registry access!

Installation

1. Install Dependencies

2. Configure Environment

Create .env:

3. Build

4. Configure Claude Desktop

Edit ~/Library/Application Support/Claude/claude_desktop_config.json:

Important: Replace /ABSOLUTE/PATH/TO/ with the actual absolute path to your project directory.

5. Restart Claude Desktop

Usage Examples

Company Search

Growth Analysis

Ownership Analysis

Market Landscape

Board Tracking

Financial Analysis

Data Sources

• Brønnøysund Enhetsregisteret: Norwegian company registry (company data, ownership, board members)

• SSB (Statistisk sentralbyrå): Statistics Norway - Enhanced with real-time data fetching

  • ✅ Real data extraction from SSB tables (not just metadata)

  • ✅ Trend analysis with automatic growth calculations

  • ✅ Time-series data with historical tracking

  • ✅ Smart filtering by NACE code, region, and time period

  • ✅ Intelligent caching for 40-60x performance improvement

  Available Data:

  • High-growth enterprises ("gaseller") with trend analysis (2006-2023)

  • Employment data by industry with growth metrics

  • Production and income by sector

  • Innovation statistics

  • New enterprise formations

  • Regional statistics

• Local SQLite cache: Enhanced with SSB response caching

  • Company data cache

  • Market analysis cache

  • NEW: SSB data cache with filter-aware storage

  • Automatic TTL-based expiration (24 hours default)

Architecture

Available Tools

1. get_company ✨ NEW

Get complete information about a specific company. Always fetches fresh data from Brønnøysund.

Parameters:

• org_nr (optional): Organization number (9 digits)

• name (optional): Company name

Example:

Returns: Complete company profile with all available data (employees, addresses, NACE codes, status, etc.)

2. search_companies (ENHANCED)

Search for Norwegian companies by name, industry, size, region. Now searches entire Brønnøysund registry!

Parameters:

• industry (optional): NACE code (e.g., '62' for IT)

• name (optional): Company name or part of name ← NOW WORKS!

• region (optional): Region/municipality

• min_employees (optional): Minimum number of employees

• max_employees (optional): Maximum number of employees

• exclude_bankrupt (optional): Exclude bankrupt companies ← DEFAULT: true ✅

• limit (optional): Max results (default: 50)

Konkurs Filtering:

• Default: Automatically excludes bankrupt/liquidated companies ✅

• Set exclude_bankrupt: false to include all companies

• Uses API &konkurs=false parameter for accurate filtering

Enhanced: Now automatically searches Brønnøysund API by name if database has few results. Access to all 500,000+ Norwegian companies!

2. analyze_growth

Identify high-growth companies in an industry or region with SSB benchmark data.

Parameters:

• industry (optional): NACE code

• region (optional): Region/county

• min_growth_percent (optional): Minimum growth percentage (default: 20)

• time_period (optional): 1_year, 3_years, or 5_years (default: 3_years)

• limit (optional): Number of results (default: 50)

SSB Integration: Compares company growth against SSB high-growth enterprise statistics.

3. analyze_ownership

Analyze ownership structure and subsidiaries.

Parameters:

• org_nr (required): Organization number (9 digits)

• include_subunits (optional): Include subsidiaries (default: true)

• depth (optional): Depth in ownership tree (default: 2)

4. track_board

Track board composition and leadership.

Parameters:

• org_nr (optional): Organization number

• company_name (optional): Company name (alternative to org_nr)

• person_id (optional): Person ID to find all boards a person sits on

5. analyze_financials

Financial analysis and bankruptcy risk assessment based on available public data.

⚠️ Important: This tool does NOT have access to financial statements (revenue, profit, assets). It analyzes based on:

• Company status (bankruptcy, liquidation)

• Employee trends (if data available)

• Registration status

• Sample/estimated data in database

For real financial data: Use Proff.no or similar commercial services.

Parameters:

• org_nr (required): Organization number

• include_risk_assessment (optional): Include bankruptcy risk analysis (default: true)

6. market_landscape

Analyze competitive landscape in an industry with SSB industry statistics.

Parameters:

• industry (required): NACE code (e.g., '62' for IT)

• region (optional): Region/county

• include_stats (optional): Include SSB statistics (default: true)

• limit (optional): Max number of companies (default: 100)

SSB Integration: When include_stats=true, enriches analysis with:

• Employment statistics by industry

• Production and income data

• High-growth enterprise benchmarks

• New enterprise formation trends

7. consolidation_trends

Analyze consolidation trends and M&A activity with SSB high-growth statistics.

Parameters:

• industry (required): NACE code

• time_period (optional): 1_year, 3_years, or 5_years (default: 3_years)

• region (optional): Region/county

SSB Integration: Includes high-growth enterprise statistics for context.

8. economic_context

Get comprehensive economic context and macro statistics from SSB (Statistics Norway).

Parameters:

• industry (optional): NACE code for specific industry

• region (optional): Region/county

• include_innovation (optional): Include innovation statistics (default: false)

Returns:

• High-growth enterprises statistics by industry

• New enterprise formations (quarterly updates)

• Employment data by industry sector

• Production and income statistics (1970-2024)

• Economic indicators

• Innovation statistics (if requested)

Example:

Enhanced Features:

• Real-time data fetching from SSB tables

• Automatic trend analysis (increasing/decreasing/stable)

• Time-series visualization data

• Cache indicators (💾 = cached, 🔄 = fresh)

• Percentage change calculations

• Period-over-period growth rates

9. fetch_financials 🚀 BREAKTHROUGH

FULLY AUTOMATED financial data fetching from Brønnøysund Regnskapsregisteret API!

Parameters:

• org_nr (required): Organization number

• auto_import (optional): Auto-save to database (default: true)

Example:

What Happens:

1. Calls Regnskapsregisteret API (automatic)

2. Downloads financial statements (JSON)

3. Extracts: Revenue, profit, assets, equity, debt

4. Calculates: Profit margin, equity ratio

5. Saves to database

6. Returns formatted analysis

Time: 3 seconds Manual work: ZERO Coverage: Companies with accounts from 2018+

Returns:

• Complete P&L and balance sheet

• Calculated financial ratios

• Ready for immediate analysis

10. get_financial_link ✨ FALLBACK

Get direct link and step-by-step guide to download annual accounts from Brønnøysund (FREE).

Parameters:

• org_nr (required): Organization number

• year (optional): Specific accounting year

Example:

Returns:

• Direct clickable link to company's Brønnøysund page

• Step-by-step download instructions

• What to extract from PDF

• Pre-formatted import command

Perfect starting point before importing financial data!

10. import_financials

Manually import financial data for a single company.

Parameters:

• org_nr (required): Organization number

• year (required): Accounting year (e.g., 2023)

• revenue (optional): Revenue in NOK

• profit (optional): Profit in NOK

• assets (optional): Total assets in NOK

• equity (optional): Total equity in NOK

• employees (optional): Employee count for that year

• source (optional): Data source (default: "manual")

Example:

10. import_financials_from_file

Bulk import financial data from CSV or JSON file.

Parameters:

• file_path (required): Absolute path to file

• format (required): "csv" or "json"

CSV Format:

See: MANUAL_IMPORT_GUIDE.md for complete guide and templates in templates/ folder.

13. auto_scrape_financials 🤖 ULTIMATE AUTOMATION

100% AUTOMATIC multi-year financial data using headless browser + PDF parsing!

Parameters:

• org_nr (required): Organization number

• auto_import (optional): Auto-save to database (default: true)

• use_api_first (optional): Try API first for latest year (default: true)

Example:

What Happens:

1. Launches headless Chrome browser

2. Navigates to virksomhet.brreg.no automatically

3. Finds ALL "Innsendt årsregnskap" links (2024, 2023, 2022...)

4. Downloads ALL PDF files

5. Parses each PDF and extracts financial data

6. Saves ALL years to database

7. Calculates multi-year growth trends

Time: 45-60 seconds Manual work: ZERO Coverage: ALL available years (typically 2018-2024) Accuracy: 80-90% (PDF parsing dependent)

Returns:

• Complete multi-year financial data

• Growth trends (CAGR, year-over-year)

• Historical overview

• All saved to database

Note: Requires Puppeteer (included). First run downloads Chromium (~170MB one-time).

14. build_financial_history 💡 SMART HELPER

Smart helper for building complete financial history.

Parameters:

• org_nr (required): Organization number

• years_needed (optional): Total years desired (default: 5)

Use when: auto_scrape_financials has issues or you want guaranteed accuracy.

15. search_bankrupt_companies 🔴 FILTERING

Search specifically for companies in bankruptcy or liquidation. Useful for market risk analysis and M&A opportunities.

Parameters:

• industry (optional): NACE code for industry

• region (optional): Region/municipality

• limit (optional): Max results (default: 50)

Example:

Use Cases:

• Market risk assessment

• Identify struggling competitors

• M&A opportunities (asset deals)

• Industry health analysis

Returns:

• List of bankrupt/liquidated companies

• Status indicators (🔴 KONKURS, ⚠️ AVVIKLING)

• Company details

Common NACE Codes

• 62: Information technology

• 64: Financial services

• 70: Management consulting

• 71: Architecture and engineering

• 45: Construction

• 46: Wholesale trade

• 47: Retail trade

• 56: Food and beverage services

Development

Important Data Limitations ⚠️

What CompanyIQ Provides ✅

• Company Information: Name, org number, addresses, contact info

• Employee Counts: Real employee numbers from NAV registry

• Industry Classification: Full NACE codes with descriptions

• Company Status: Bankruptcy, liquidation, registration status

• Organizational Structure: Subunits, subsidiaries (35+ for Equinor)

• SSB Statistics: Industry trends, high-growth stats, employment data

• Market Analysis: Company discovery, competitive landscape

What CompanyIQ Does NOT Provide ❌

• Financial Statements: NO revenue, profit, assets, equity data

• Credit Ratings: Not available from public APIs

• Detailed Financials: Balance sheets, P&L, cash flow

• Multi-year Financials: Historical financial comparisons

Why the Limitation?

The public Brønnøysund Enhetsregisteret API is a company registry, not a financial database. While a Regnskapsregisteret (Accounting Registry) API exists for financial data, it appears to:

• Require special access

• Have undocumented endpoints

• Be in "preview" status

For Real Financial Data:

• Manual Import ✅ - Download free from Brønnøysund, import to CompanyIQ (see MANUAL_IMPORT_GUIDE.md)

• Proff.no - Commercial API with complete financials

• Bisnode - Credit ratings and financial data

See FINANCIAL_DATA_GUIDE.md for detailed alternatives.

💡 NEW: Automated Financial Workflow

Don't want to pay for Proff.no? No problem!

The 3-Step Process:

1. Use get_financial_link to get the download link

2. Click link → Download FREE from Brønnøysund

3. Use import_financials to import the data

4. Full financial analysis with REAL data!

See: FINANCIAL_WORKFLOW.md for complete guide (5 minutes per company)

What Works Great:

• ✅ Company search and discovery

• ✅ Industry analysis with SSB data

• ✅ Market intelligence

• ✅ Employee-based growth tracking

• ✅ Competitive landscape analysis

Bottom Line: CompanyIQ excels at market intelligence and company discovery, but requires commercial services for detailed financial analysis.

License

MIT

Author

Built with Claude Code 🚀