Skip to main content

MCP stdio-server exposing Firmaradar's company/person/risk tools to AI agents.

Project description

Firmaradar

Firmaradar MCP-server

Slå opp norske selskaper, eierstrukturer, konsernhierarkier og roller direkte fra Claude, ChatGPT, Cursor, Codex, Gemini og andre MCP-kompatible agenter.

PyPI Python Lisens: Apache 2.0 MCP Norsk data

Koble til (anbefalt) →  ·  Verktøykatalog  ·  Kom i gang  ·  Prising  ·  Dokumentasjon


Hva er dette?

Firmaradar er Norges agentiske infrastruktur for selskapsdata. Denne MCP-serveren gir AI-agenten din direkte tilgang til:

  • 2,1 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

17 verktøy, alle med samme oppsett i Python (firmaradar-mcp på PyPI) og TypeScript (@firmaradar/mcp-server på npm):

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_find_related_companies — finn relaterte selskaper via eierskap, roller eller adresse

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

Bransje og overvåkning

  • firmaradar_list_companies_in_nace — alle selskaper i en NACE-kode med geografisk filter
  • 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

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


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/            — 17 verktøy-moduler
│   └── tests/
└── typescript/               — npm-pakken «@firmaradar/mcp-server»
    └── src/

Bygget av Firmaradar AS — agentisk infrastruktur for norske selskapsdata.

firmaradar.no  ·  Prising  ·  Dokumentasjon  ·  Personvern

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

firmaradar_mcp-0.3.0.tar.gz (52.8 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

firmaradar_mcp-0.3.0-py3-none-any.whl (71.8 kB view details)

Uploaded Python 3

File details

Details for the file firmaradar_mcp-0.3.0.tar.gz.

File metadata

  • Download URL: firmaradar_mcp-0.3.0.tar.gz
  • Upload date:
  • Size: 52.8 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.12

File hashes

Hashes for firmaradar_mcp-0.3.0.tar.gz
Algorithm Hash digest
SHA256 b3f7896565b977c336cdbe884f17f1ec19f83952c73dd1172c4193626dce46fe
MD5 d28da501e2ff5033682ddd5f3f7905af
BLAKE2b-256 032ad9991f48a072a056192e9598cda302d8ee8b22980b31fc48d45939a3ce4e

See more details on using hashes here.

Provenance

The following attestation bundles were made for firmaradar_mcp-0.3.0.tar.gz:

Publisher: publish.yml on Tiwas/firmaradar-mcp

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file firmaradar_mcp-0.3.0-py3-none-any.whl.

File metadata

  • Download URL: firmaradar_mcp-0.3.0-py3-none-any.whl
  • Upload date:
  • Size: 71.8 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.12

File hashes

Hashes for firmaradar_mcp-0.3.0-py3-none-any.whl
Algorithm Hash digest
SHA256 62d082bf90e01536df1437de7819cbe8bc1128867be81ebeb45bf8f714a04d1a
MD5 0b3c3d50f479f62601d2cea39c31e786
BLAKE2b-256 1370471cea31398442c95a2f0fc1fa04621811d0cb1ae1a0594204703b5213d8

See more details on using hashes here.

Provenance

The following attestation bundles were made for firmaradar_mcp-0.3.0-py3-none-any.whl:

Publisher: publish.yml on Tiwas/firmaradar-mcp

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page