CompanyIQ MCP Server

# Guide: Accessing Norwegian Company Financial Data ## Problem Statement CompanyIQ MCP Server provides excellent **company intelligence** from public APIs, but **financial statements** (revenue, profit, assets) are **not available** from the free Brønnøysund Enhetsregisteret API. --- ## What CompanyIQ DOES Provide ✅ ### From Brønnøysund Enhetsregisteret - Company identification and contact info - **Employee counts** (actual numbers from NAV) - Industry classification (NACE codes) - Ownership structure (basic) - Board composition (limited, requires auth) - Bankruptcy/liquidation status - Subunits and subsidiaries ### From SSB (Statistics Norway) - Industry-wide statistics - High-growth enterprise trends - Employment trends by sector - Production values (aggregated) - Innovation statistics - New company formations ### What This Enables: - ✅ Company discovery and search - ✅ Market landscape analysis - ✅ Industry trend analysis - ✅ Growth pattern identification - ✅ Competitive intelligence - ✅ Employee-based risk assessment --- ## What CompanyIQ DOES NOT Provide ❌ ### Missing Financial Data: - Revenue/omsetning - Profit/resultat - Assets/eiendeler - Equity/egenkapital - Liabilities/gjeld - Cash flow - Detailed P&L statements - Balance sheets - Financial ratios (ROE, ROA, etc.) ### Why? The public Brønnøysund APIs separate company **registry data** from **financial data**. While a Regnskapsregisteret (Accounting Registry) API exists, it appears to: - Be in "preview" status - Have unclear/undocumented endpoints - Possibly require special access - May not be fully publicly available --- ## 🎯 Solutions for Financial Data ### Option 1: Commercial API Services (Recommended) #### **Proff.no API** **Website:** https://www.proff.no **API:** https://proff.no/api **Provides:** - Complete financial statements - Multi-year comparisons (5-10 years) - Credit ratings - Risk scores - Ownership details - Board members - Market analysis **Pricing:** Subscription-based **Integration:** REST API available **Coverage:** ~500,000 Norwegian companies **How to Integrate with CompanyIQ:** 1. Get Proff.no API key 2. Create `src/apis/proff.ts` client 3. Add to config.ts 4. Update financial_analysis tool 5. Populate financial_snapshots table --- #### **Bisnode (Dun & Bradstreet)** **Website:** https://www.bisnode.no **Provides:** - Financial data - Credit scores (AAA rating system) - Risk indicators - International company data **Pricing:** Commercial **Integration:** API available for enterprise --- ### Option 2: Manual Data Collection #### **Brønnøysund Web Portal** **URL:** https://www.brreg.no/ **Steps:** 1. Search for company 2. View "Regnskapsopplysninger" 3. Download PDF annual reports 4. Manual data entry **Pros:** Free **Cons:** Time-consuming, not scalable --- #### **Altinn** **URL:** https://www.altinn.no/ Where companies submit their accounts. **Pros:** Official source **Cons:** No bulk access, manual only --- ### Option 3: Web Scraping (Not Recommended) **Proff.no Web Scraping:** - Technically possible - Against terms of service - Unreliable (page structure changes) - Legal issues - NOT RECOMMENDED --- ### Option 4: Dataset Purchase **SSB Microdata:** - Buy aggregated datasets - For research purposes - No individual company IDs - Statistical analysis only --- ## 🔧 Integration Roadmap ### Phase 1: Current State ✅ - Brønnøysund company registry - SSB statistics - Employee-based analysis - Industry trends ### Phase 2: Enhanced Free Data (Possible) - [ ] Attempt Regnskapsregisteret API again - [ ] Check for updated documentation - [ ] Contact Brønnøysund for API access - [ ] Implement if available ### Phase 3: Commercial Integration (Requires Subscription) - [ ] Get Proff.no API access - [ ] Create Proff client - [ ] Integrate financial data - [ ] Enable full due diligence --- ## 💡 Workarounds for Current Version ### 1. Use Employee Count as Proxy Employee growth/decline often correlates with financial health: ```typescript // CompanyIQ already does this! const employeeChange = latest.employees - previous.employees; if (employeeChange < -5) { riskScore += 10; factors.push('Reduced workforce'); } ``` ### 2. Leverage SSB Industry Data Compare company size to industry averages: - If company has 100 employees in sector with avg 20 → Strong player - If company has 5 employees in sector with avg 50 → Small player ### 3. Bankruptcy Status Strong indicator of financial health: ```typescript if (company.konkurs) { return { risk: 'CRITICAL' }; } ``` ### 4. Registration Status Companies in MVA registry and Foretaksregisteret are typically more established. --- ## 📊 What You CAN Do with CompanyIQ ### Excellent For: 1. **Market Research** - "Find all IT companies in Oslo" - "Show me competitors in NACE 62" 2. **Industry Analysis** - "What's the market landscape for fintech?" - "Show consolidation trends in construction" 3. **Company Discovery** - "Find high-growth companies in tech sector" - "List companies with 50-200 employees in Bergen" 4. **Competitive Intelligence** - "Who are the major players in industry X?" - "What's the market concentration?" 5. **Ownership Mapping** - "Show me all subsidiaries of company X" - "What's the ownership structure?" ### Limited For: 1. **Financial Due Diligence** ⚠️ - Can assess basic risk - Cannot analyze detailed financials - Need commercial service for full analysis 2. **Credit Assessment** ⚠️ - Can check bankruptcy status - Cannot calculate credit scores - Need Bisnode/Proff for ratings 3. **Valuation** ❌ - No revenue/profit data - Cannot calculate multiples - Need commercial data --- ## 📝 Next Steps ### Immediate: 1. ✅ Document limitations clearly 2. ✅ Update README to set expectations 3. ✅ Fix employee count display 4. ✅ Add data source disclaimers ### Short-term: - [ ] Research Regnskapsregisteret API access process - [ ] Contact Brønnøysund for API documentation - [ ] Evaluate Proff.no API pricing ### Long-term: - [ ] Consider Proff.no integration (if budget allows) - [ ] Build hybrid model (free + commercial data) - [ ] Add manual financial data import feature --- **Updated:** 2025-11-12 **Status:** Limitations documented, workarounds implemented **Recommendation:** Use CompanyIQ for market intelligence, supplement with Proff.no for financial deep-dives