Firmaradar

---

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, DSAR-eksport 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

Cursor, Codex eller andre — API-nøkkel via stdio

Hvis klienten din ikke støtter ekstern MCP, kan du kjøre serveren lokalt:

pip install firmaradar-mcp

~/.cursor/mcp.json eller ~/.codex/config.toml:

{
  "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 (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

---

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

---

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

---

Støtte og spørsmål

• Feil i denne MCP-serveren → GitHub Issues
• Spørsmål om data eller priser → kontakt Firmaradar
• Salg eller partnerskap → [email protected]

---

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/

---