Model Context Protocol
MCP-server for norske selskapsdata
Apier drifter en MCP-server for norske selskapsdata på https://www.apier.no/api/mcp over Streamable HTTP. En MCP-klient som Claude, Cursor eller VS Code kobler seg til denne ene adressen og leser ferske data fra Brønnøysundregistrene (Brreg). I tillegg til selskapsfakta gir serveren selskapets registrerte signaturregler, en verifiseringsstatus som sier om selskapet er aktivt, signerte bevispakker og endringshistorikken Apier har observert. En sandkasse svarer uten registrering.
Koble til klienten din
Alle klienter kobler seg til det samme endepunktet. Du kan liste verktøyene uten nøkkel. For å kalle et selskapsverktøy trenger du en API-nøkkel fra kontrollpanelet, sendt som bearer i en header, eller sandkassens bearer som er beskrevet i neste avsnitt.
https://www.apier.no/api/mcpClaude Code
Kjør én kommando i en terminal. Claude Code lagrer serveren og sender headeren med hvert kall.
claude mcp add --transport http apier https://www.apier.no/api/mcp \
--header "Authorization: Bearer apr_free_<your_key_here>"Claude (egen kobling i claude.ai)
Koblingen logger inn med OAuth, så du skriver ikke inn noen API-nøkkel i Claude.
- Åpne «Customize» og deretter «Connectors» i claude.ai.
- Klikk «Add» og deretter «Add custom connector».
- Skriv Apier som navn og endepunktet over i feltet «MCP server URL», og klikk «Continue».
- Velg «Sign in now» under «Authentication» og «Register automatically» under «OAuth client».
- Klikk «Add» og deretter «Connect», og tillat koblingen på samtykkesiden hos Apier.
Når du tillater koblingen, lager Apier en egen nøkkel på kontoen din. Kall som går gjennom koblingen, belastes denne nøkkelen. Veiledning steg for steg til koblingen i Claude.
Cursor
Legg serveren i brukerfilen ~/.cursor/mcp.json, ikke i filen inne i et prosjekt. Pakken @apier-no/mcp på npm er en tynn lokal mellomstasjon til det samme endepunktet.
{
"mcpServers": {
"apier": {
"command": "npx",
"args": [
"-y",
"@apier-no/mcp"
],
"env": {
"APIER_API_KEY": "apr_free_<your_key_here>"
}
}
}
}VS Code
VS Code i agentmodus kobler seg rett til endepunktet. Programmet spør etter nøkkelen én gang og lagrer den, så filen inneholder ingen nøkkel.
{
"inputs": [
{
"type": "promptString",
"id": "apier-api-key",
"description": "Apier API key",
"password": true
}
],
"servers": {
"apier": {
"type": "http",
"url": "https://www.apier.no/api/mcp",
"headers": {
"Authorization": "Bearer ${input:apier-api-key}"
}
}
}
}Claude Desktop
Åpne «Settings», «Developer» og «Edit Config», legg inn blokken og start Claude Desktop på nytt.
{
"mcpServers": {
"apier": {
"command": "npx",
"args": [
"-y",
"@apier-no/mcp"
],
"env": {
"APIER_API_KEY": "apr_free_<your_key_here>"
}
}
}
}Gemini CLI
Legg serveren i brukerinnstillingene dine. Gemini CLI bruker feltet httpUrl for en server over Streamable HTTP.
{
"mcpServers": {
"apier": {
"httpUrl": "https://www.apier.no/api/mcp",
"headers": {
"Authorization": "Bearer apr_free_<your_key_here>"
}
}
}
}Hold filer som inneholder en nøkkel, utenfor versjonskontroll. Hele klientreferansen, også for OpenAI Agents SDK og Azure AI Foundry, står i dokumentasjonen for MCP.
Prøv uten konto
7 verktøy kjører uten API-nøkkel: get_public_obligations, get_exchange_rate, get_public_deadlines, explain_compliance_error, get_altinn_migration_guidance, get_pricing, redeem_issuance_token. Ingen av dem returnerer data om ett bestemt selskap.
For selskapsverktøyene sender du sandkassens bearer i stedet for en API-nøkkel. Den krever ingen registrering. Legg til et tilfeldig suffiks du lager selv, for eksempel en ny UUID, slik at økten din ikke kolliderer med andres.
Authorization: Bearer apier_sandbox_test_<suffix>Med denne beareren svarer 10 verktøy med syntetiske selskaper, og hvert slikt svar er merket som sandkassedata. Ingen kall i sandkassen når et offentlig system. Bruk de reserverte organisasjonsnumrene i sandkassen. Seriene 818, 99966 og 99977 består kontrollsifferet som selskapsverktøyene krever, og GET /api/v1/sandbox/fixtures lister alle sammen.
curl -sS https://www.apier.no/api/mcp \
-H "Content-Type: application/json" \
-H "Accept: application/json, text/event-stream" \
-H "Authorization: Bearer apier_sandbox_test_<suffix>" \
-d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"get_company_authority","arguments":{"org_number":"818000006"}}}'Verktøy
Serveren lister 20 verktøy. Tabellen lages fra det samme registeret som serveren svarer på tools/list fra, så den stemmer med det klienten din ser.
| Verktøy | Hva det svarer på | API-nøkkel | Pris per kall |
|---|---|---|---|
get_company_summary | Hvilke plikter og frister som gjelder for selskapet, i ett kall. | Nøkkel eller sandkassens bearer | Målt, 50 øre |
get_public_obligations | Hvilke plikter som gjelder for en organisasjonsform, for eksempel AS eller ENK. | Ingen nøkkel | Ingen kostnad |
get_exchange_rate | Norges Banks valutakurs for en valuta mot norske kroner. | Ingen nøkkel | Ingen kostnad |
get_company_profile | Den strukturerte selskapsprofilen registeret har for et organisasjonsnummer. | Nøkkel eller sandkassens bearer | Målt, 50 øre |
get_company_context | Selskapets identitet i registeret: organisasjonsform, status og registreringsfakta. | Nøkkel eller sandkassens bearer | Målt, 50 øre |
get_company_deadlines | Når selskapets innsendinger forfaller. | Nøkkel eller sandkassens bearer | Målt, 50 øre |
get_company_obligations | Hvilke registrerte plikter som gjelder for selskapet. | Nøkkel eller sandkassens bearer | Målt, 50 øre |
get_public_deadlines | Den generelle norske fristkalenderen for et år. | Ingen nøkkel | Ingen kostnad |
explain_compliance_error | Hva en feilkode fra Apier betyr, og hvordan kallet rettes. | Ingen nøkkel | Ingen kostnad |
search_companies | Hvilke organisasjonsnumre som passer til et selskapsnavn. | Nøkkel eller sandkassens bearer | Ingen kostnad |
get_company_verification | Om selskapet er registrert og aktivt: pass, warn, fail eller unknown, med flaggene bak statusen. | Nøkkel eller sandkassens bearer | Målt, 50 øre |
get_company_authority | Selskapets registrerte signaturregler: signaturrett og prokura. | Nøkkel eller sandkassens bearer | Målt, 50 øre |
get_company_accounts | Siste øyeblikksbilde av årsregnskapet: innsendingsstatus og nøkkeltall. | Nøkkel eller sandkassens bearer | Målt, 50 øre |
get_company_evidence_pack | Én signert registrering av det Apier observerte om selskapet. | Nøkkel eller sandkassens bearer | Målt, 50 øre |
get_company_history | Tilstanden Apier hadde observert for selskapet på en dato, eller endringene Apier observerte i en periode. | Nøkkel eller sandkassens bearer | Målt, 50 øre |
list_changes | Hvilke endringer Apier har oppdaget i kildene den følger, siden en dato. | Nøkkel eller sandkassens bearer | Ingen kostnad |
get_altinn_migration_guidance | Hvilken ressurs i Altinn 3 som erstattet en tjenestekode eller rollekode i Altinn 2. | Ingen nøkkel | Ingen kostnad |
get_pricing | Hva hvert målte kall koster. | Ingen nøkkel | Ingen kostnad |
get_credit_balance | Hvor mye forhåndsbetalt kreditt kontoen har igjen. | Nøkkel eller sandkassens bearer | Ingen kostnad |
redeem_issuance_token | Bytter et engangstoken fra kontoeieren mot agentens egen API-nøkkel. | Ingen nøkkel | Ingen kostnad |
Eksempler på spørsmål
Du spør med vanlige ord. Modellen leser verktøylisten og velger kallene. Disse spørsmålene fører vanligvis til verktøykjedene som vises.
- Finn organisasjonsnummeret til Nordic Widgets AS og fortell meg hvordan selskapet signerer.
search_companies→get_company_context→get_company_authority - Er selskapet med organisasjonsnummer 818000006 registrert og aktivt?
get_company_verification - Sjekk at 818000006 er aktivt, og vis deretter signaturregelen og hvem som har prokura.
get_company_verification→get_company_authority - Gi meg en signert registrering av det registeret viser om dette selskapet i dag.
get_company_evidence_pack - Hva observerte dere om dette selskapet 1. oktober, og hva har endret seg siden?
get_company_history - Hva koster disse oppslagene, og hvor mye kreditt er igjen?
get_pricing→get_credit_balance
Signaturrett gjennom MCP
get_company_authority tar et organisasjonsnummer og returnerer selskapets registrerte signaturregler: signaturrett og prokura slik Brønnøysundregistrene har dem. Dette er kallet for sandkasseselskapet 818000006.
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "get_company_authority",
"arguments": {
"org_number": "818000006"
}
}
}{
"classification": "joint",
"summary": "Selskapet signeres av flere roller i fellesskap.",
"combinations": [
{
"kombinasjons_id": "SANDBOX-KOMB-DAGL-STYRL-FELLES",
"description": "Daglig leder og styrets leder i fellesskap.",
"role_codes": [
"DAGL",
"STYRL"
]
},
{
"kombinasjons_id": null,
"description": "Prokura tildelt rollen PROKU.",
"role_codes": [
"PROKU"
]
}
]
}Klassifiseringen joint betyr at den registrerte kombinasjonen nevner to roller som signerer i fellesskap. I produksjon er beskrivelsen registerets egen tekst, returnert som data. Kjør get_company_verification først: svaret om signatur ser ikke på konkurs eller oppløsning. Alle feltene i svaret, og det samme kallet over REST.
Datakilder og lisens
Serveren leser kilder som publiserer åpne data, og hvert svar oppgir kildene det er bygget på.
- Brønnøysundregistrene, Enhetsregisteret: selskapsfakta og rolleinnehavere.
- Brønnøysundregistrene, Fullmakttjenesten: kodet signaturrett og prokura per organisasjon.
- Brønnøysundregistrene, Regnskapsregisteret (åpen del): innsendingsstatus og nøkkeltall.
- Norges Bank: daglige valutakurser, med Norges Bank oppgitt som kilde.
- GLEIF: registreringer av LEI som brukes i selskapskontrollene. Source: GLEIF Global LEI Index (CC0 1.0).
Data fra Brønnøysundregistrene gjenbrukes under NLOD 2.0 (Norsk lisens for offentlige data) med denne kildehenvisningen:
Inneholder data under Norsk lisens for offentlige data (NLOD) tilgjengeliggjort av Brønnøysundregistrene.
Registrene går ikke god for Apier. Verktøysvar som bygger på en lisensiert kilde, har lisens og kildehenvisning i metadata.source_licences. Alle datakilder og lisenser.
Priser og grenser
Oppslag på selskaper er målt. Hvert målte verktøykall trekker 50 øre (NOK 0.50) fra en forhåndsbetalt saldo i norske kroner. Det finnes ikke noe abonnement. Du fyller på fra NOK 50 til NOK 10,000 om gangen, og ubrukt kreditt utløper 12 måneder etter kjøpet.
Tabellen over viser hvilke verktøy som er målt. Verktøyene uten nøkkel, søk på selskapsnavn, endringsarkivet og din egen saldo koster ingenting. Kall i sandkassen bruker syntetiske data og koster ingenting.
Kall uten nøkkel deler én grense på 100 forespørsler per time per IP-adresse. Med nøkkel gir første nivå 30 forespørsler per minutt på selskapsdata. Priser, påfyll og alle grensene.
Dette gjør serveren ikke
- Den oppgir selskapets registrerte signaturregler og avgjør aldri om en person kan signere et bestemt dokument. Din egen prosess bruker reglene.
- Den har ingen verktøy for autorisasjon i Altinn, fullmakt eller hvem som kan handle for hvem. Disse verktøyene ble trukket tilbake 2026-10-21, og et kall som nevner et av dem, svarer CAPABILITY_WITHDRAWN.
- Den har ingen innsendingshistorikk og ingen innsending av mva. Apier leverer ikke innsendinger til det offentlige.
- Den kontrollerer ikke identiteten til personer og er ikke en screeningtjeneste.
- Den dekker selskaper i de norske registrene.
Ofte stilte spørsmål
- Finnes det en MCP-server for data fra Brreg?
- Ja. Apier drifter en på https://www.apier.no/api/mcp. Den leser åpne data fra Brønnøysundregistrene (Brreg) og lister 20 verktøy. Apier er en uavhengig tjeneste, og registrene går ikke god for den.
- Trenger jeg en API-nøkkel til MCP-serveren?
- Ikke for å koble til eller liste verktøyene. 7 offentlige verktøy kjører også uten nøkkel. Selskapsverktøyene krever en API-nøkkel, eller sandkassens bearer hvis du vil ha syntetiske data uten registrering.
- Hvilke MCP-klienter virker?
- Alle klienter som bruker Streamable HTTP, blant dem Claude Code, egen kobling i claude.ai, VS Code og Gemini CLI. Claude Desktop og Cursor kan bruke pakken @apier-no/mcp, en lokal mellomstasjon til det samme endepunktet.
- Gir serveren signaturrett og prokura?
- Ja. get_company_authority returnerer selskapets registrerte signaturregler: kombinasjonene for signaturrett og prokura med registerets tekst og rollekoder. Verktøyet avgjør ikke om en person kan signere et bestemt dokument.
- Hva koster MCP-serveren?
- Et målt oppslag på et selskap koster 50 øre fra en forhåndsbetalt saldo, uten abonnement. Verktøyene uten nøkkel, søk på selskapsnavn og kall i sandkassen koster ingenting.
- Hvor kommer dataene fra?
- Fra Brønnøysundregistrene (Enhetsregisteret, Fullmakttjenesten og den åpne delen av Regnskapsregisteret) under NLOD 2.0, fra Norges Bank for valutakurser og fra GLEIF for LEI.
- Finnes siden på engelsk?
- Ja. Denne siden finnes også på engelsk, og verktøylisten har beskrivelser på bokmål ved siden av de engelske.
Relaterte sider
- Oppsett av MCP-klienter og verktøyreferanse: alle klientblokkene, autentisering og protokollversjoner (på engelsk).
- API for signaturrett og prokura fra Brreg: signaturreglene som JSON over REST, felt for felt.
- Norsk signaturrett for AI-agenter: hva en agent trenger før den handler.
- Know Your Business Agent (KYBA): selskapslaget når en agent handler for et selskap.
- Sandkasse: prøv endepunktene i nettleseren (på engelsk).
- Priser: prisen per målte oppslag og grensene.
- Guide: Hvordan kobler jeg Claude eller Cursor til norske selskapsdata med MCP?
- Guide: Hvordan integrerer jeg en AI-agent med Apier over MCP?
- Guide: Hvordan kobler jeg apier.no til Claude?
Kom i gang
Prøv et verktøykall i sandkassen, eller les hele oppsettet for klienter.