Dokumentasjon

Koble til Brreg og ta det i bruk

Alt du trenger: hvordan du kobler til, verktøyene assistenten får, hvor dataene kommer fra, grensene og hvordan personopplysninger behandles.

Koble til

Brreg er en ekstern MCP-server. Assistenten kobler seg til én adresse, og du logger inn med Publifye-kontoen din. Tilgangen gis kun gjennom denne innloggingen — det finnes ingen API-nøkkel å lage, kopiere eller bytte.

https://brreg.publifye.com/mcp

Tilgang krever et Brreg-abonnement på Publifye-kontoen din. Se abonnementene

Claude på nett og Claude Desktop

  1. Åpne Innstillinger (Settings) og deretter Koblinger (Connectors).
  2. Velg «Legg til egendefinert kobling» (Add custom connector), gi den navnet Brreg og lim inn adressen over.
  3. Velg Koble til (Connect), logg inn med Publifye-kontoen din og godkjenn tilgangen.
  4. Sjekk at Brreg er slått på i verktøymenyen (tools menu) i samtalen, og still spørsmålet ditt.

Claude Code

Legg til serveren én gang, og kjør /mcp i Claude Code for å logge inn:

claude mcp add --transport http brreg https://brreg.publifye.com/mcp

Andre MCP-klienter

Transport
Streamable HTTP (JSON-RPC over POST) på adressen over.
Innlogging
OAuth 2.1 med PKCE mot Publifye-innloggingen. Klienter registrerer seg selv automatisk (dynamisk klientregistrering), så det er ingenting å sette opp på forhånd.
Oppdagelse
https://brreg.publifye.com/.well-known/oauth-protected-resource

Verktøy

Dette er verktøyene assistenten får når du kobler til, hentet rett fra serveren i drift. Alle leser bare data.

entity_lookup

Slår opp én eller flere organisasjoner på organisasjonsnummer og gir oppføringen i registeret. Nøkkeltall fra regnskap, årene med innsendte årsregnskap og selve det innsendte dokumentet bare når du ber om dem.

  • compact
  • cursor
  • document_year
  • fields
  • include_subunits
  • live
  • max_bytes
  • orgnr
  • orgnrs
  • snapshot_id

entity_nearby

Finds the organisations registered nearest a map point, closest first, with the distance to each. The point is the address in the register, not where the business actually operates.

  • radius_km
  • city
  • compact
  • cursor
  • employees_max
  • employees_min
  • fields
  • kind
  • lat
  • limit
  • lon
  • max_bytes
  • municipality
  • nace
  • org_form
  • orgnr
  • parent_orgnr
  • postcode
  • public_body
  • sector
  • snapshot_id
  • status
  • vat_registered

entity_distance

Measures how far apart organisations are, and which of several is nearest a given place. This is the straight-line distance between registered addresses, not driving distance and not travel time.

  • from
  • to
  • compact
  • cursor
  • max_bytes
  • snapshot_id

entity_financials

Fetches key figures from the annual accounts, the years a company has actually filed, a comparison with its industry, and the filed document itself, only for the companies you ask about.

  • compact
  • cursor
  • document_year
  • include
  • max_bytes
  • orgnr
  • orgnrs
  • snapshot_id

entity_resolve

Gjør et firmanavn, også et tidligere navn, om til mulige organisasjoner med nummer, uten å velge én for deg.

  • name
  • compact
  • cursor
  • fields
  • include_deleted
  • kind
  • limit
  • max_bytes
  • municipality
  • public_body
  • snapshot_id

entity_structure

Viser hvordan organisasjoner henger sammen: overordnet enhet, underenheter og, for offentlige virksomheter, etatene under.

  • orgnr
  • compact
  • cursor
  • fields
  • limit
  • max_bytes
  • section
  • snapshot_id

code_list

Lister kodene du kan filtrere på, som organisasjonsformer, næringer og kommuner.

  • list
  • compact
  • cursor
  • fields
  • limit
  • max_bytes
  • query
  • snapshot_id

snapshot_status

Forteller hvor ferske registerdataene er: når de sist ble hentet fra Brønnøysundregistrene.

  • detail
  • max_bytes

operator_guide

Explains what Brreg can do, how to connect, and ways to use it with your assistant.

Søk nær et sted

Gi entity_search et punkt og en radius (lat, lon og radius_km), så lister det virksomheter med registrert adresse innenfor avstanden, nærmeste først, hver med avstand og adressepunkt. Med et navn i søket sorteres treffene fortsatt etter relevans, og radiusen virker som et filter.

  • Radiusen kan være opptil 10 km alene, eller opptil 50 km sammen med et annet filter, for eksempel organisasjonsform, næring eller et navn.
  • Punktet er Kartverkets adressepunkt for den registrerte adressen – forretningsadressen for hovedenheter og beliggenhetsadressen for underenheter. Det er ikke omrisset av en bygning, og ikke nødvendigvis der arbeidet utføres.
  • Adresser oppgitt som c/o, postbokser, utenlandske adresser og adresser som ikke kan kobles til adresseregisteret, får ikke noe punkt og kommer aldri med i et radiussøk.
  • Mange virksomheter deler én adresse, for eksempel et regnskapskontor. Hvert treff viser hvor mange som deler punktet.
entity_search lat=60.3913 lon=5.3221 radius_km=2 org_form=["KIRK"]

Match et felt med et mønster

Gi entity_search et match-filter, så beholder det bare organisasjonene der feltet samsvarer med mønsteret ditt – opptil fire av dem, ett per felt, brukt sammen med de andre filtrene dine.

  • Sju felt kan matches: activity, address, city, email, name, phone og website.
  • Mønstre er RE2-regulære uttrykk, matchet uten hensyn til store og små bokstaver, og du forankrer dem selv. Et frittstående punktum sjekker bare at feltet i det hele tatt finnes.
  • Forankre når du kan: ^post snevrer inn søket og er raskt. Et uforankret mønster leser hver verdi i feltet sitt første gang det brukes – omtrent et tiendedels sekund – og svaret beholdes deretter for senere forespørsler.
  • Matching kjører mot ukeutgaven, så en organisasjon som er registrert, eller en verdi som er endret, siden forrige oppbygging, matches mot det utgaven inneholdt.
entity_search match=[{"field":"email","pattern":"^post"}] municipality="4601"

Data og kilder

Enhetsregisteret
Hovedenheter og underenheter fra Brønnøysundregistrene, bygget på nytt fra hele registeret hver uke. Mellom hver oppbygging oppdaterer registerets egen oppdateringsstrøm – som leses omtrent én gang i timen, sjeldnere om natten – oppføringene ukeutgaven allerede har, og fjerner dem som er slettet; en organisasjon som er registrert etter forrige oppbygging, finner du med et oppslag på organisasjonsnummer, men den dukker ikke opp i søkeresultater før neste. Når en oppføring fjernes fra de åpne dataene, forsvinner den fra Brreg innen 24 timer.
Regnskapsregisteret
Nøkkeltall fra det sist innsendte årsregnskapet, hvilke regnskapsår en organisasjon faktisk har sendt inn for, og selve det innsendte årsregnskapet: det komplette dokumentet slik det ble sendt inn, omtrent femten år tilbake, og den eneste veien for banker og forsikringsselskaper der nøkkeltall ikke er tilgjengelig. Det leveres som en privat lenke som utløper, og det er et skannet bilde uten tekstlag, så det er ment for et menneske å åpne og lese, ikke noe en assistent kan hente tall ut av. Alt hentes bare når du uttrykkelig ber om det, og tallene viser alltid året de gjelder.
Kartverkets adressepunkter
Det nasjonale adresseregisteret (Matrikkelen – Adresse) fra Kartverket, hentet hver uke og koblet til hver virksomhets registrerte adresse for å plassere den på kartet.
Matrikkelenhet og bygninger
For en virksomhet med kartpunkt: matrikkelenheten (gnr/bnr, og seksjonsnummer når adressen har nøyaktig én seksjon), grunnkrets, sokn og tettsted, og de eksisterende bygningene på adressen når minst én av dem ikke er en bolig. Hentes hver uke fra Kartverkets Matrikkelen – Adresse, Bygningspunkt og Adresse Leilighetsnivå. Det er matrikkelenheten på den registrerte adressen, ikke eiendom virksomheten eier.
Koder
Organisasjonsformer, kommuner, næringskoder (NACE) og institusjonelle sektorer, med antall, slik registeret publiserer dem.
Aktualitet
Hvert svar oppgir hvilken ukeutgave av registeret det kommer fra. Et oppslag på organisasjonsnummer viser også endringer publisert siden da, merket med når de ble hentet, og assistenten kan spørre hvor ferske dataene er.

Ikke med

  • Roller og personer: ingen styremedlemmer, daglige ledere eller eiere.
  • Det fullstendige årsregnskapet som data: detaljerte regnskapsposter, noter og revisjonsberetning – bare nøkkeltallene over leveres som data. Selve det innsendte dokumentet er tilgjengelig på forespørsel som en privat lenke som utløper, men det er et skannet bilde uten tekstlag, så ingenting i det kan søkes i eller tolkes maskinelt; er det større enn 40 MiB, formidles det ikke, og svaret oppgir i stedet den åpne kilden du kan hente det fra.
  • Kontaktinformasjon, tidligere navn og aktivitetstekst for enkeltpersonforetak.
  • Masseuttrekk eller kopier av registeret.

Grenser

Daglige kall
Hvert abonnement har en daglig kvote med verktøykall per Publifye-konto. Den nullstilles ved midnatt UTC. Kvoter per abonnement
Nøkkeltall og innsendte årsregnskap
Opptil 30 nye oppslag i Regnskapsregisteret per minutt per konto, delt mellom nøkkeltall og innsendingshistorikk. Et innsendt dokument er på mange megabyte, så det har et langt strammere budsjett: 3 i minuttet. Utover det får du det som allerede er hentet, eller en beskjed om når du kan prøve igjen.
Svarstørrelse
Omtrent 24 KiB per svar som standard, justerbart fra 4 til 48 KiB. Lengre resultater fortsetter med en markør som gjelder i 15 minutter.
Radius
Høyst 10 km for en radius alene og 50 km sammen med et annet filter.
Søkedybde
Et søk blar helt til slutten av treffene: følg markøren, og ingenting faller bort. Bare offset-snarveien, som hopper fremover på det første kallet, stopper ved 10 000.

Når den daglige kvoten er brukt opp

Frem til nullstillingen avvises kall med en feilmelding som assistenten kan lese og forklare. Den ser slik ut:

{"reason": "quota_exceeded", "service": "brreg-service", "window": "day", "limit": …, "resets_at": "…T00:00:00Z"}

Personvern

  • Brreg handler om organisasjoner. Det er ikke et personregister og kan ikke brukes til å slå opp personer.
  • Et enkeltpersonforetak er knyttet til én person, så for disse holder Brreg tilbake tidligere navn, aktivitetstekst og kontaktinformasjon, og et søk uten navn viser dem aldri.
  • Ingen oppslag av privatpersoner ut fra adresse alene, og ingen masseuttrekk.
  • Matrikkelenhet og bygninger følger samme regel: ingenting for enkeltpersonforetak, underenhetene deres eller adresser oppgitt som c/o. Opplysninger fra matrikkelen kan ikke brukes til reklame eller markedsføring uten samtykke fra den opplysningene gjelder (utleveringsforskriften § 5 tredje ledd).
  • Enkeltpersonforetak og underenhetene deres får ikke noe kartpunkt, kommer aldri med i et radiussøk og telles ikke med når et punkt deles.
  • Nøkkeltall hentes bare når du ber om dem.
  • Dette logger vi: for hvert verktøykall på en kundekonto registreres kontoen, klientens IP-adresse, verktøyet og utfallet — aldri argumentene du sender. Revisjonssporet lagres i 365 dager.
  • Fjerninger: når Brønnøysundregistrene fjerner en oppføring fra de åpne dataene, fjerner Brreg den innen 24 timer.

Lisens og kildehenvisning

Registerdataene er åpne data fra Brønnøysundregistrene under Norsk lisens for offentlige data (NLOD 2.0). Hvert svar har med kildehenvisningen lisensen krever:

Inneholder data under Norsk lisens for offentlige data (NLOD) tilgjengeliggjort av Brønnøysundregistrene.

Kartpunkter og avstander kommer fra Matrikkelen – Adresse, © Kartverket, lisensiert under Creative Commons Navngivelse 4.0 (CC BY 4.0). Publifye har koblet adressepunktene til hver virksomhets registrerte adresse; de viser ikke hvor virksomheten faktisk holder til. Svar med punkter eller avstander har også denne kildehenvisningen. Les CC BY 4.0

Svar med matrikkelenhet eller bygninger sier at opplysningene utleveres fra et privat register, slik utleveringsforskriften § 5 tiende ledd krever.

Brreg drives av Publifye AS og er ikke det offisielle registeret. Bruk den offisielle oppføringen på virksomhet.brreg.no til alt som er juridisk bindende. Les lisensen

Support

Spørsmål, et feil svar eller noe som mangler? Kontakt Publifye support og nevn Brreg. Kontakt support

Kom i gang