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.1.tar.gz (53.4 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.1-py3-none-any.whl (72.5 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: firmaradar_mcp-0.3.1.tar.gz
  • Upload date:
  • Size: 53.4 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.1.tar.gz
Algorithm Hash digest
SHA256 7c3ce25c05d12b47d59677516b456805e1e459d79440c3cf0b37c461256251e8
MD5 9cb069458fa0762ce3c83df66ff87b7c
BLAKE2b-256 a589cf08388c777b7a190ba5ee3fd114456e7e7ab7947e88f591b029cbfb2bb4

See more details on using hashes here.

Provenance

The following attestation bundles were made for firmaradar_mcp-0.3.1.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.1-py3-none-any.whl.

File metadata

  • Download URL: firmaradar_mcp-0.3.1-py3-none-any.whl
  • Upload date:
  • Size: 72.5 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.1-py3-none-any.whl
Algorithm Hash digest
SHA256 3ee9bdf5d07e9acdc7cab28d7c1a9b020a0d1f4ce01d8fafdcdb036ea5ee999c
MD5 a7e0f54ec59088594df0cd094532cead
BLAKE2b-256 771afd01b9a191d0d873f552839d0e026dcc88486bd39d7a5415109839b85b86

See more details on using hashes here.

Provenance

The following attestation bundles were made for firmaradar_mcp-0.3.1-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