README.md•2.72 kB
# Personupplysning MCP Server
> **MCP server för svensk företags- och persondata** via Bolagsverket API och Supabase cache
Personupplysning – en MCP-server som visar och hjälper LLMs och AI-chatbotar att hitta data och uppgifter om svenska företag, styrelser, och dylikt.
## 🚀 Features
- **Full MCP Protocol Implementation** - Tools, Resources, Prompts, and Notifications
- **Företagssökning** - Sök bland 1.85M svenska företag i lokal databas
- **Företagsdetaljer** - Hämta fullständig företagsinformation från Bolagsverket
- **Årsredovisningar** - Ladda ner och parsera iXBRL årsredovisningar
- **Smart caching** - Supabase cache-first strategi (30 dagar företagsdata, 7 dagar dokument)
- **Structured Logging** - Request IDs, duration tracking, and MCP notifications
- **HTTP MCP Server** - Publikt tillgänglig via Render deployment
- **Local development** - Stdio mode för lokal utveckling
## 📋 MCP Capabilities
### Tools (Active Operations)
| Tool | Description | Cache |
|------|-------------|-------|
| `search_companies` | Sök företag lokalt (1.85M) | Lokal DB |
| `get_company_details` | Hämta företagsinfo | 30 dagar |
| `get_company_documents` | Lista årsredovisningar | 7 dagar |
| `get_annual_report` | Hämta iXBRL årsredovisning | Permanent |
| `get_cache_stats` | Cache-statistik | - |
### Resources (Passive Data Access)
Resources expose company data as URIs that can be read by clients:
| Resource URI | Description | Example |
|--------------|-------------|---------|
| `company://search?q={query}&limit={limit}` | Search results | `company://search?q=Nordea&limit=10` |
| `company://{orgId}` | Company details | `company://5560001712` |
| `company://{orgId}/documents` | Document list | `company://5560001712/documents` |
| `company://{orgId}/report/{year}` | Annual report | `company://5560001712/report/2023` |
| `company://stats` | Cache statistics | `company://stats` |
### Prompts (Reusable Templates)
Pre-configured prompts for common business analysis workflows:
| Prompt | Description | Arguments |
|--------|-------------|-----------|
| `analyze_company_finances` | Analyze financial health | `organisationsidentitet`, `year?` |
| `compare_competitors` | Compare with competitors | `organisationsidentitet`, `competitor_org_numbers` |
| `find_company_relationships` | Find related companies | `organisationsidentitet` |
| `generate_company_report` | Generate comprehensive report | `organisationsidentitet`, `include_financials?` |
## 📧 Support
For issues or questions:
- Open a GitHub issue
- Check existing issues first
---
**Built with:** TypeScript, MCP SDK, Supabase, Bolagsverket API
**Deployed on:** Render (EU region - Frankfurt)