@ketl/mcp v0.5.0

Hent komplett aggregert selskaps-profil for et norsk orgnr. Returnerer Brreg-grunndata, Wikidata-enrichment, OpenCorporates, GLEIF LEI, Brreg-roller og Brreg-regnskap (3 siste år). De nordiske søsterregistrene (CVR DK, YTJ FI, Bolagsverket SE, Skatteverket SE) returneres som status:'not-applicable' — et norsk 9-sifret orgnr er strukturelt ikke en gyldig oppslagsnøkkel der, så ingen forespørsel sendes. Partiell suksess: kilder som feiler returneres som status:'error' uten å blokkere de øvrige. Eksempel: orgnr='923609016' for Equinor ASA.

selskap.profil({ orgnr: "923609016" })

Søk etter norske foretak i Enhetsregisteret (Brreg) på navn, organisasjonsform, kommune eller bransje. Returnerer liste med foretak inkl. orgnr, navn, org.form, adresse og næringskode. Bruk orgnr fra resultatene til å hente mer info via brreg.enhet.lookup. Minst én søkeparameter er anbefalt. Eksempel: navn='Equinor' finner alle foretak med Equinor i navnet. naeringskode='41' finner alle byggeselskaper (NACE-topp 41). kommunenummer='0301' + organisasjonsform='AS' finner alle AS i Oslo.

brreg.enheter.search({})

Hent alle registrerte roller og rolleinnehavere for et norsk selskap fra Brønnøysundregistrene (Brreg). Returnerer rollegrupper med rolle-kode (DAGL=daglig leder, STYR=styremedlem, LEDE=styreleder, PROKURA=prokura, REVISOR=revisor, DTSO=daglig leder/styremedlem) og for hver person: fullt navn, fødselsdato og fratredelsestidspunkt (null = aktiv). Nyttig for due diligence, KYB (Know Your Business), eierskapsanalyse og sanksjonscompliance. Eksempel: orgnr='984851006' for DNB Bank ASA returnerer hele styret, daglig leder og revisor.

brreg.roller.lookup({ orgnr: "923609016" })

Hent endrings-/hendelsesloggen for et norsk selskap — tidslinjen av registrerte endringer (living business record + event-driven review). Wrapper /api/v1/companies/{orgnr}/events. Kjernen i overvåkings-/KYB-moaten: hva endret seg og når. Eksempel: orgnr='923609016' for Equinor ASA.

selskap.events({ orgnr: "923609016" })

Nøkkeltall-sammendrag for siste regnskapsår til et norsk foretak fra Brreg Regnskapsregisteret. Beregner driftsinntekter, årsresultat, sum egenkapital, sum gjeld, egenkapitalprosent og gjeldsgrad. Brukes for hurtig finansiell screening, konkursrisiko-flagging og kreditvurdering. Foretrekker SELSKAP-type framfor KONSERN. Cache 30 dager. Eksempel: orgnr='923609016' returnerer nøkkeltall for Equinors siste årsregnskap.

brreg.regnskap.summary({ orgnr: "910747711" })

Hent liste over KOSTRA-tabeller som har data for et gitt kommunenummer. Brukes for å identifisere hvilke indikatorer som er tilgjengelig for en spesifikk kommune. Returnerer tabell-ID, tittel og tidsdekning per tabell. Eksempel: kommunenummer='0301' returnerer KOSTRA-tabeller med Oslo-data.

ssb.kostra.kommune({ kommunenummer: "0301" })

Fritekst-søk i norske adresser via Kartverket Adresse REST-API (sentral adresseregister). Returnerer adresser med WGS84-koordinater, postnummer, poststed, kommunenummer og kommunenavn. Brukes for norsk adresse-autocomplete, geocoding og adresse-standardisering. Eksempel: sok='Karl Johans gate 1, Oslo' returnerer Stortinget-adressen med koordinater.

kartverket.adresse.sok({ sok: "Karl Johans gate Oslo" })

Slå opp matrikkelenhet i Norges offisielle eiendomsregister via Kartverket. Returnerer grunndata om en eiendom: areal, eierform, bruksnavn, etableringsår og tilknyttede adresser. Brukes for eiendomsanalyse, due diligence og verdsettelse. Eksempel: kommunenr='0301', gnr=1, bnr=1 slår opp eiendom i Oslo.

Hent NOK-valutakurser fra Norges Bank. Standard: siste kurs for USD, EUR, SEK, DKK, GBP, CHF og JPY. Kan hente historikk via startPeriod/endPeriod (ISO-8601 dato, f.eks. '2024-01-01').

norges-bank.valutakurs({})

Kjør en KETL analyseapp og få det sammensatte resultatet (alle kildene appen fletter, med herkomst). Speiler REST-ruten GET /api/v1/apps/{slug}/run og bruker samme delte kjerne. Bruk ketl.apps.list først for å finne slug + paramSpecs (typet spec med example/enum/discover per påkrevd param). Eksempel: slug="selskap", params={orgnr:"923609016"} → {app, params, data:{brreg,…}, _sources (herkomst per kilde), partial}. Tomt resultat (ingen treff) er IKKE en feil — da er data null og partial=true. Free-tier-apper kjøres anonymt; tier="pro"-apper krever Authorization: Bearer <api-nøkkel> (ellers 401 app-auth-required, #4455).