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.2.tar.gz (54.2 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.2-py3-none-any.whl (72.9 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: firmaradar_mcp-0.3.2.tar.gz
  • Upload date:
  • Size: 54.2 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.2.tar.gz
Algorithm Hash digest
SHA256 87d1fd6e248ccc9454f5cb08de7e5be70e19ca5ff3596d4c4d857708cdcec7d9
MD5 84d28d006f834d129f34ede866dc1439
BLAKE2b-256 de1831b7615225647c32cc3b58eabbf8649702d759fd1a112a0f62198e26a1b2

See more details on using hashes here.

Provenance

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

File metadata

  • Download URL: firmaradar_mcp-0.3.2-py3-none-any.whl
  • Upload date:
  • Size: 72.9 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.2-py3-none-any.whl
Algorithm Hash digest
SHA256 a9b538e136018a1a903b1c1a7136e611a3a000b3411330af7ea0ae0361ef34cc
MD5 3a61a55ffc3e3b36cd052d23664cfd7b
BLAKE2b-256 05994db48a3655b14aff4c596ed0be7f49240224bf459f87f4324c1bf33491c1

See more details on using hashes here.

Provenance

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