# Firmaradar MCP-server
**Slå opp norske selskaper, eierstrukturer, konsernhierarkier og roller direkte fra Claude, ChatGPT, Cursor, Codex, Gemini og andre MCP-kompatible agenter.**
[](https://pypi.org/project/firmaradar-mcp/)
[](https://pypi.org/project/firmaradar-mcp/)
[](https://opensource.org/licenses/Apache-2.0)
[](https://modelcontextprotocol.io)
[](https://firmaradar.no)
[**Koble til (anbefalt) →**](https://firmaradar.no/koble-til-agent) ·
[Verktøykatalog](#verktøykatalog) ·
[Kom i gang](#kom-i-gang) ·
[Prising](https://firmaradar.no/prising) ·
[Dokumentasjon](https://firmaradar.no/dokumentasjon)
---
## Hva er dette?
Firmaradar er Norges agentiske infrastruktur for selskapsdata. Denne MCP-serveren gir AI-agenten din direkte tilgang til:
- **Mer enn 2 millioner norske enheter** (BRREG-grunnregister, oppdatert daglig)
- **Aksjeeierregisteret** fra Skatteetaten (eierandeler ned til person-nivå, opp gjennom hele konsernet)
- **Roller** (styre, daglig leder, prokura) med historikk
- **Regnskap** (årsregnskap, mellombalanser, signaler)
- **Kunngjøringer** fra Brønnøysund og KYC-flagg
- **AML/PEP-screening** med revisjonsspor
- **NACE-bransjeovervåkning** (varsling ved nystiftet selskap i bransje og geografi)
Bygget for produksjon: OAuth 2.0 og DCR (Claude Mobile og Web støttes), API-nøkkel som alternativ (Cursor og Codex), [loggført per kall](https://firmaradar.no/dokumentasjon), [DSAR-eksport](https://firmaradar.no/dokumentasjon) og GDPR-pseudonymisering på serversiden.
---
## Kom i gang
### Anbefalt — OAuth (Claude Web, Claude Mobile, Claude Desktop)
Lim inn denne adressen som tilkobling i klienten din. Du logger inn via firmaradar.no-konto og velger hvilken API-nøkkel agenten skal bruke.
```
https://mcp.firmaradar.no/mcp
```
Detaljert veiledning per klient: **[firmaradar.no/koble-til-agent](https://firmaradar.no/koble-til-agent)**
### Cursor, Codex eller andre — API-nøkkel via stdio
Hvis klienten din ikke støtter ekstern MCP, kan du kjøre serveren lokalt:
```bash
pip install firmaradar-mcp
```
`~/.cursor/mcp.json` eller `~/.codex/config.toml`:
```json
{
"mcpServers": {
"firmaradar": {
"command": "firmaradar-mcp",
"env": {
"FIRMARADAR_API_KEY": "din-nøkkel-fra-firmaradar.no/min-side/api-keys",
"FIRMARADAR_API_BASE": "https://firmaradar.no"
}
}
}
}
```
Hent API-nøkkel: **[firmaradar.no/min-side/api-keys](https://firmaradar.no/min-side/api-keys)** (krever konto).
---
## Verktøykatalog
35 verktøy — Python-pakka (`firmaradar-mcp` på PyPI) og remote-serveren (`mcp.firmaradar.no`) eksponerer alle:
### Selskaps-oppslag
- `firmaradar_search_companies` — søk på navn eller orgnr
- `firmaradar_get_company` — full profil (organisasjonsform, NACE, ansatte, adresse, regnskap, eiere, roller)
- `firmaradar_get_company_ownership` — konsernhierarki opp og ned, eierandeler, person-nivå
- `firmaradar_get_company_roles` — styre, daglig leder, prokura (med fratrådt-historikk)
- `firmaradar_get_company_financials` — årsregnskap, nøkkeltall og signaler
- `firmaradar_get_company_announcements` — BRREG-kunngjøringer (vedtak, fusjoner, oppløsninger)
- `firmaradar_get_company_signals` — risikoflagg, KYC-flagg, insolvens
- `firmaradar_get_company_ip` — IP-portefølje fra Patentstyret: patenter, varemerker og design (totaler, aktive, enkeltrettigheter med status og lenke)
- `firmaradar_find_related_companies` — finn relaterte selskaper via eierskap, roller eller adresse
- `firmaradar_find_shared_connections` — skjulte koblinger på tvers av 2–10 selskaper (felles styre, adresse, eiere/morselskap, sirkulært eierskap) med risikonivå og graf
### Person-oppslag (krever full tilgang)
- `firmaradar_search_persons` — navne-søk med toleranse for skrivefeil
- `firmaradar_get_person` — profil med adresse og fødselsår
- `firmaradar_get_person_companies` — alle selskaper personen eier eller har rolle i
- `firmaradar_get_person_roles` — aktive og historiske roller
### KYC og AML
- `firmaradar_check_aml_pep` — full AML/PEP-screening med sanksjonslister og revisjonsspor
- `firmaradar_get_aml_score` — strukturert AML-risikoscore (0–100) med revisjonsspor
- `firmaradar_start_aml_report` — start en asynkron, revisjonssikker AML-rapport (for tunge eierstrukturer eller mange parallelle screeninger); lagret 60 mnd per hvitvaskingsloven §35
- `firmaradar_get_aml_report` — hent status og resultat (score, nivå, lenke) for en asynkron AML-rapport via `report_id`
- `firmaradar_check_konkurs_eksponering` — screen en person på navn for konkurseksponering: lederverv i selskaper som senere gikk konkurs, tidsvektet (review-flagg, ikke dom)
### Bransje, overvåkning og abonnement
- `firmaradar_list_companies_in_nace` — alle selskaper i en NACE-kode med geografisk filter
- `firmaradar_list_nace_codes` — søk og bla i NACE-katalogen (SSB/BRREG); slå opp riktig kode, eller konverter EU NACE Rev. 2 → norske underkoder
- `firmaradar_get_recent_changes` — endringer siste N dager for et orgnr
- `firmaradar_search_announcements` — fritekst-søk i BRREG-kunngjøringer
- `firmaradar_compare_companies` — sammenlikne flere selskaper side om side
- `firmaradar_add_company_monitoring` — legg et selskap til overvåkning; varsel ved kunngjøringer, statusendring (konkurs/oppløsning), eierskifte eller nye offentlige tilskudd
- `firmaradar_subscribe_nace` — abonner på bransjeovervåkning (NACE) med webhook ved hendelser i bransjen; filtrer på hendelsestype, geografi og størrelse
- `firmaradar_list_my_subscriptions` — list dine NACE-abonnement (id, kode, webhook, filtre, status)
- `firmaradar_delete_subscription` — slett ett NACE-abonnement på id (idempotent)
### Risiko, FIV og konsern
- `firmaradar_get_risk_score` — transparent selskaps-risikoscore (0–100) med komponent-breakdown
- `firmaradar_get_risk_score_bulk` — risikoscore for en portefølje orgnr i ett kall
- `firmaradar_check_foretak_i_vanskeligheter` — lovbestemt «foretak i vanskeligheter» (FIV)-vurdering
- `firmaradar_check_fiv_bulk` — FIV-status for en portefølje orgnr i ett kall
- `firmaradar_get_konsernstotte` — offentlig støtte gjennom konsernet (tre-struktur)
- `firmaradar_confirm_risk_score_disclaimer` — bekreft pre-screening-disclaimer før risk-score-verktøyene
### Valuta
- `firmaradar_convert_nok` — konverter NOK-beløp til EUR/USD/GBP/SEK/DKK med dagskurser fra Norges Bank (NOK-originalen bevares alltid)
Full API-referanse og eksempel-prompter: **[firmaradar.no/dokumentasjon](https://firmaradar.no/dokumentasjon)**
---
## Priser
Vi tilbyr én **plattformavgift (99 kr/mnd)** + per-kall-prising. MCP-kallene har en egen pakke (`mcp_full`) som er rabattert for agentbruk siden agenter genererer høyere volum enn manuelle API-integrasjoner.
Detaljert prising: **[firmaradar.no/prising](https://firmaradar.no/prising)**
---
## Hvorfor åpen kildekode?
- **Transparens** — du kan lese hver verktøy-modul og se nøyaktig hva agenten sender til Firmaradar.
- **Tillit gjennom gjennomgang** — koden er Apache 2.0. Gå gjennom den selv, eller lås til en spesifikk versjon.
- **Bidrag velkommen** — vi tar imot pull requests som forbedrer skjemaer eller legger til kompatibilitets-lag for nye klienter.
Backend (firmaradar.no) er proprietær fordi den eier dataflyten og lisensieringen mot Skatteetaten og Brønnøysund.
---
## Sikkerhet og GDPR
- OAuth 2.0 og PKCE (RFC 7636), Dynamic Client Registration (RFC 7591), Protected Resource Metadata (RFC 9728)
- Alle delegerte tokens er lagret i PostgreSQL, knyttet eksplisitt til en API-nøkkel kunden valgte, og kan tilbakekalles uavhengig
- Loggføring per kall (kunde-id, nøkkel-id, endepunkt og status) — eksporteres via DSAR-rapport
- Person-data pseudonymiseres på serversiden; sikkerhetskopier er kryptert og lagres eksternt
Hele sikkerhets-policyen: **[firmaradar.no/personvern](https://firmaradar.no/personvern)**
---
## Støtte og spørsmål
- **Feil i denne MCP-serveren** → [GitHub Issues](https://github.com/Tiwas/firmaradar-mcp/issues)
- **Spørsmål om data eller priser** → [kontakt Firmaradar](https://firmaradar.no/kontakt)
- **Salg eller partnerskap** → lars@firmaradar.no
---
## Mappestruktur
```
tools/mcp_server/
├── README.md — denne filen
└── python/ — pip-pakken «firmaradar-mcp» (PyPI)
├── pyproject.toml
├── firmaradar_mcp/
│ ├── server.py — MCP stdio og ekstern (streamable-HTTP)
│ ├── remote_server.py — OAuth 2.0 og DCR for Claude Mobile/Web
│ ├── client.py — REST-API-wrapper
│ └── tools/ — 35 verktøy-moduler
└── tests/
```
---
**Bygget av [Firmaradar AS](https://firmaradar.no)** — agentisk infrastruktur for norske selskapsdata.
[firmaradar.no](https://firmaradar.no) · [Prising](https://firmaradar.no/prising) · [Dokumentasjon](https://firmaradar.no/dokumentasjon) · [Personvern](https://firmaradar.no/personvern)