CompanyIQ MCP Server

# CompanyIQ MCP Server - Quick Start Guide ## 🚀 5-Minute Setup ### 1. Configure Claude Desktop Edit: `~/Library/Application Support/Claude/claude_desktop_config.json` ```json { "mcpServers": { "companyiq": { "command": "node", "args": [ "/Users/josuekongolo/Downloads/mcp/companyiq-mcp/build/index.js" ] } } } ``` ### 2. Restart Claude Desktop Completely quit and reopen Claude Desktop. ### 3. Verify It Works In Claude Desktop chat: ``` What tools do you have available? ``` You should see 8 CompanyIQ tools listed. --- ## 📋 Quick Reference ### Search Companies ``` Find IT companies in Bergen with more than 50 employees ``` ### Growth Analysis ``` Show me the fastest growing companies in the tech sector (NACE 62) ``` ### Market Landscape ``` Give me a market landscape analysis for Norwegian fintech ``` ### Economic Context (SSB Data) ``` Get economic context for IT sector with trends and statistics ``` ### Get Financial Data (AUTOMATIC!) 🚀 ``` Method 1 - FULLY AUTOMATIC (Recommended): "Fetch financials for 893905952" → Downloads automatically from API in 3 seconds! Method 2 - Manual (for historical data): Step 1: Get financial link for 923609016 Step 2: [Click link, download PDF] Step 3: Import financial data... ``` **See:** `AUTO_FETCH_EXPLAINED.md` for details ### Ownership Analysis ``` Analyze the ownership structure of company 123456789 ``` ### Board Tracking ``` Who sits on the board of DNB? ``` ### Financial Analysis ``` Assess the bankruptcy risk for company 123456789 ``` ### Consolidation Trends ``` Show consolidation trends in the construction industry ``` --- ## 🏷️ Common NACE Codes | Code | Industry | |------|----------| | 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 | --- ## 🐛 Troubleshooting ### Server not showing up? 1. **Check config path:** ```bash cat ~/Library/Application\ Support/Claude/claude_desktop_config.json ``` Path must be absolute (no `~`) 2. **Check logs:** ```bash tail -f ~/Library/Logs/Claude/mcp-server-companyiq.log ``` 3. **Rebuild if needed:** ```bash cd /Users/josuekongolo/Downloads/mcp/companyiq-mcp npm run build ``` 4. **Restart Claude Desktop** (quit completely, then reopen) ### Common Errors **"ENOENT: mkdir './data'"** ✅ Fixed in v1.1.0 ```bash npm run build ``` **Server crashes on start:** ```bash # Check logs cat ~/Library/Logs/Claude/mcp-server-companyiq.log # Verify build ls build/index.js ls build/database/schema.sql ``` --- ## 💡 Pro Tips ### Get Rich Industry Context Always use the `economic_context` tool for macro insights: ``` Get economic context for NACE 62 with innovation statistics ``` This provides: - Real SSB data (not just metadata) - Trend analysis (increasing/decreasing/stable) - Time-series data (last 5 periods) - Growth percentages - Cache indicators ### Combine Tools ``` 1. First: "Get economic context for IT sector" 2. Then: "Find high-growth IT companies in Oslo" 3. Finally: "Analyze ownership of the top company" ``` ### Use Caching Second calls are 40-60x faster! - First call: 🔄 Ferske data (2-3 seconds) - Second call: 💾 Data fra cache (50ms) --- ## 📊 What You Get ✅ **8 Analysis Tools** - Company search & filtering - Growth identification - Ownership mapping - Board tracking - Financial risk assessment - Market landscape - Consolidation trends - Economic context ✅ **Real SSB Data** - High-growth enterprises (2006-2023) - Employment by industry - Time-series with trends - Automatic calculations ✅ **Smart Features** - Filter by NACE, region, time - Intelligent caching (24h TTL) - Trend analysis - 40-60x performance boost --- ## 📖 Full Documentation - **README.md** - Complete feature list - **SETUP.md** - Detailed installation - **SSB_INTEGRATION.md** - SSB API details - **SSB_ENHANCEMENTS.md** - Advanced features - **CHANGELOG.md** - Version history --- **Version:** 1.1.0 | **Tools:** 8 | **Performance:** 40-60x cached | **Data Sources:** Brønnøysund + SSB