Veiledning for utviklere
Altinn for AI-agenter
Hva en AI-agent kan og ikke kan gjøre med Altinn i dag, og hvor den får maskinverifiserbar norsk signaturrett: fra Brønnøysund, gjennom MCP-serveren til Apier.
Hva er Altinn for AI-agenter?
Altinn er den felles plattformen for digital dialog mellom næringsliv og offentlig sektor i Norge, driftet av Digdir. For en AI-agent er Altinn to helt forskjellige ting: skjemaene og meldingene en virksomhet sender inn og mottar, og autorisasjonen (roller, tilgangspakker og delegeringer) som avgjør hvem som får gjøre hva. Denne siden forklarer hvor grensen går for en agent, og hva Apier tilbyr i stedet: status, roller og kodet signaturrett for et norsk selskap, hvert svar stemplet med kilde og verifiseringsdato.
Lurer du på hvor grensen for en agent faktisk går? Hvordan kan AI-agenter trygt få tilgang til norske offentlige tjenester? går gjennom autoritetskjeden og hva agenten har lov til å gjøre uten at et menneske er involvert.
Og selve grunnlagsproblemet, altså hvor fakta kommer fra: Hvordan får AI-agenter norske selskapsfakta uten å hallusinere? forklarer hvorfor et oppslag slår en modellgjetning.
Hva kan en AI-agent gjøre med norske selskapsdata i dag?
Alt som er åpne registerdata. Brønnøysundregistrene publiserer Enhetsregisteret, Foretaksregisteret, rollene, signaturretten og prokuraen under Norsk lisens for offentlige data (NLOD), som uttrykkelig tillater kommersiell bruk. Det er dette laget Apier bygger på:
- Hvem kan signere, og hvordan. Signaturrett og prokura hentes fra Fullmakttjenesten hos Brønnøysundregistrene og kodes som rollekombinasjoner (alene, i fellesskap, styrets leder sammen med ett styremedlem) med klausulteksten ordrett og en ufortolket tilstand når teksten ikke lar seg kode.
- Status og roller. Registrert, under avvikling, konkurs eller slettet; daglig leder, styre, revisor og regnskapsfører som rollekoder.
- Plikter og frister som støttelag. MVA-terminer, A-melding, skattemelding og årsregnskap, utledet deterministisk fra organisasjonsform og registerfakta, med lovhenvisning per plikt.
Hva kan en AI-agent ikke gjøre i Altinn gjennom Apier?
Agenten kan ikke handle på vegne av et selskap i Altinn gjennom Apier, og Apier svarer ikke på om en person eller et system har lov til å handle for et selskap i Altinn. Tre grunner:
- Autorisasjonen eies av selskapet og av Altinn. Roller, tilgangspakker og delegeringer i Altinn Autorisasjon bestemmer hvem som får gjøre hva. Skal et system handle for en virksomhet, oppretter og godkjenner virksomheten selv en systembruker i Altinn for et registrert sluttbrukersystem, og kan trekke den tilbake. Det er en avtale mellom virksomheten, systemleverandøren og Digdir, ikke noe en tredjepart kan formidle.
- Vilkårene tillater ikke kommersiell bruk av autorisasjonsdata. Bruksvilkårene for sluttbrukersystemleverandører i Altinn (versjon 1.0, 2025) sier at API-ene og dataene bare kan brukes til eller som et ledd i offentlig oppgaveløsning, og at privatrettslig bruk ikke er tillatt. Altinn Servicedesk bekreftet skriftlig, etter juridisk vurdering, 21. oktober 2026 at opplysninger fra Altinn Autorisasjon ikke kan brukes som grunnlag for en kommersiell tjeneste, med eller uten systembruker, og at det ikke finnes noe unntak.
- Innsending er en handling i selskapets navn. En MVA-melding eller en A-melding sendes inn av selskapet selv, gjennom selskapets eget regnskapssystem med egen systembruker, eller av en person med rett rolle som logger inn selv. Apier sender ikke inn skjemaer, lager ikke utkast for innsending og øver ikke på innsending. Den delen av veikartet er satt på vent til Digdir eller Skatteetaten svarer skriftlig på om det er lov.
Konsekvensen for koden din er enkel: hvert endepunkt og MCP-verktøy som før tilbød fullmakt, handleevne eller prøveinnsending gjennom Apier, svarer nå med 410 CAPABILITY_WITHDRAWN og peker videre til signaturrett. Agenten mister ingen registerdata.
Hva gjør MCP-serveren til Apier for agenten?
Apier eksponerer sine leseverktøy over Model Context Protocol. Agenten din oppdager og kaller deterministiske verktøy: kodet signaturrett og prokura for et selskap, status og roller, en tillitssjekk før agenten handler, pliktene og fristene som støttelag, og Compliance Explainer. Hvert svar har samme form som det ville fått over REST. Under panseret gjør disse komponentene jobben:
- Registry Engine. Kanonisk selskapstilstand: status, roller og kodet signaturrett fra Brønnøysund, med klausulteksten ordrett, avstemt til én kontekst.
- Universal Rulebook. Versjonerte regulatoriske regler med henvisninger i legal_reference; deterministisk evaluering, så samme inndata pluss regelbokversjon gir identisk utdata, byte for byte.
- Deadline Engine. MVA-terminer, kadens for A-melding, skattemelding, årsregnskap: kalendermatematikk i Europe/Oslo som tar hensyn til sommertid og helligdager.
- MCP Server. Leseverktøyene er tilgjengelige over Model Context Protocol på
/api/mcp, pakket som@apier-no/mcppå npm. Ingen av dem leser eller skriver i Altinn. - AI-Agent Discovery.
llms.txt,llms-full.txt,workflows.json,/api/v1/capabilitiesog manifestene under well-known, hver flate for maskinoppdagelse fylt ut og stabil. - Compliance Explainer. Hver Apier-
error_codeløses opp til etexplanation-omslag på norsk bokmål (summary, why, fix_steps, legal_basis, handover) viaPOST /api/v1/explain.
Slik fungerer det
Registrene eksponerer rådata. Det som mangler, er laget som oversetter alt dette til ett deterministisk, maskinlesbart svar en agent kan planlegge mot.
- Steg 01
Ett kall
Du kaller ett Apier-endepunkt med et organisasjonsnummer, ikke Brønnøysund, Skatteetaten og Altinn hver for seg.
- Steg 02
Signaturrett kodes
Apier henter selskapstilstand, roller, signaturrett og prokura fra Brønnøysund og koder signaturretten som rollekombinasjoner med klausulteksten ordrett.
- Steg 03
Regler evalueres
Regelboken utleder pliktene og fristene deterministisk: samme inndata og regelbokversjon gir samme svar.
- Steg 04
Strukturert svar
Du får ett normalisert svar med en _meta-blokk som viser opphav, ferskhet og regelbokversjon.
Hvordan er agentens oppslag sporbare?
Hver API-respons hashes med SHA-256 inn i en provenienslogg som bare kan utvides, og hver regelevaluering tas vare på etter correlation_id med regelbokversjonen som gjaldt. Hvilken regel som gjaldt, hva Apier returnerte og hvilken registerkilde svaret bygget på kan rekonstrueres fra én enkelt correlation_id, fra første kall og utover, uansett prisnivå.
Hvordan kan en agent betale for seg?
I dag er det en person som fyller på den forhåndsbetalte saldoen. Apier legger til betalingskanaler for agenter, slik at en agent kan fylle på selv, med oppgjør gjennom Stripe. Ingen kanal for agenter er slått på ennå: les GET /api/v1/payments/options for å se hva som er i drift. Stablecoin kommer først, over x402 (USDC på Base) og MPP (USDC.e på Tempo, USDC på Solana). Kortbetaling med Shared Payment Tokens er ikke tilgjengelig for denne kontoen ennå.
- Machine Payments Protocol (MPP) er en åpen standard utviklet av Tempo og Stripe, lansert 18. mars 2026. Betalinger over MPP havner i virksomhetens vanlige saldo hos Stripe, i standardvalutaen og etter den vanlige utbetalingsplanen. Kilde: bloggen til Stripe, Introducing the Machine Payments Protocol.
- Stripe støtter betaling i stablecoin over MPP (USDC.e på Tempo, USDC på Solana) og x402 (USDC på Base), og refusjon gjennom Refunds API. Kilde: dokumentasjonen til Stripe, Machine payments.
Grenser, refusjon, vilkår og flytene som kommer, står i veiledningen om agentbetaling (på engelsk).
Kodeeksempel
Slipp @apier-no/mcp inn i enhver MCP-kompatibel klientkonfigurasjon, og leseverktøyene til Apier blir tilgjengelige. Samme svar er tilgjengelig over JSON-RPC og over ren REST.
{
"mcpServers": {
"apier": {
"command": "npx",
"args": ["-y", "@apier-no/mcp"],
"env": { "APIER_API_KEY": "apr_free_<your_key_here>" }
}
}
}// An MCP-compatible harness (Claude Desktop, Cursor, custom) calls the
// get_company_authority tool over MCP JSON-RPC. Apier answers from
// Brønnøysund's Fullmakttjenesten (NLOD) with the coded signing authority.
{
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"name": "get_company_authority",
"arguments": { "org_number": "999999999" }
},
"id": 1
}# The same answer over REST, for any HTTP client.
curl -H "Authorization: Bearer apr_free_<your_key_here>" \
"https://www.apier.no/api/v1/company/999999999/authority"Kildekode + issues: github.com/PowerLaunch/apier-mcp. Pakke: npmjs.com/package/@apier-no/mcp.
Hvor finner jeg API-referansen?
Hvert verktøy er tilordnet et dokumentert REST-endepunkt; den fullstendige referansen ligger i OpenAPI 3.1-spesifikasjonen, utviklerdokumentasjonen og MCP-integrasjonsguiden.
Hva gjør agenter med det?
- Selskapets registrerte signaturregler som kodet signaturrett: rollekombinasjonene, klausulteksten ordrett og en ufortolket tilstand, stemplet med kilde og verifiseringsdato.
- Kjør en tillitssjekk før en avtale, en faktura eller en onboarding: registrert, aktiv, ikke under avvikling, med synlig signaturrett.
- Svar på “hva må dette selskapet levere, og når?” som støttelag, uten at agenten lærer norsk skatterett.
- Legg svaret, med kilde og verifiseringsdato, inn i agentens egen beslutning: hvem i selskapet som må godkjenne, og at godkjenningen skjer i selskapets egne systemer, ikke gjennom Apier.
Hvordan kommer jeg i gang?
Å koble til en agent er tre steg. MCP-verktøyene og REST-endepunktene gir de samme svarene, så du kan starte begge veier.
- Slipp
@apier-no/mcpinn i konfigurasjonen til MCP-klienten din (kodebiten over), eller pek HTTP-klienten din mot REST-flaten; hvert MCP-verktøy har en REST-motpart. - Prøv det mot sandkassen uten autentisering først. Kjør curl mot sandkassespeilet for syntetisk org
999999999, uten nøkkel og uten sertifikat. - Opprett en Apier-API-nøkkel, sett
APIER_API_KEY, og gi den lesescopet (read:*) agenten din trenger. Mer trengs ikke: alt Apier tilbyr er lesing av åpne registerdata.
Vanlige spørsmål
Fungerer Apier med Model Context Protocol (MCP)?
Ja. Agenten får kodet signaturrett over MCP: npm-pakken @apier-no/mcp faller inn i enhver MCP-kompatibel klient (Claude Desktop, Cursor, egne agentoppsett) via npx, og agenten din får leseverktøyene til Apier over den standard JSON-RPC-protokollen: get_company_authority for signaturrett og prokura, get_company_verification for en tillitssjekk, get_company_context for status og roller, og som støttelag get_company_obligations, get_company_deadlines og explain_compliance_error. Hvert MCP-verktøy har en REST-motpart, så du får de samme svarene begge veier. Ingen av verktøyene leser eller skriver i Altinn.
Kan agenten min lese selskapets registrerte signaturregler gjennom Altinn?
Signaturrett og prokura er registerdata fra Brønnøysundregistrene, ikke Altinn-data, og de er åpne under Norsk lisens for offentlige data (NLOD). Det er der Apier henter dem: GET /api/v1/company/{org}/authority og MCP-verktøyet get_company_authority returnerer signaturretten kodet, med klausulteksten ordrett, en ufortolket tilstand, kilde og verifiseringsdato. Altinn trengs ikke for dette spørsmålet, og Apier leser ikke Altinn Autorisasjon.
Kan agenten min handle på vegne av et norsk selskap i Altinn, for eksempel sende inn MVA-melding?
Ikke gjennom Apier. Å handle i Altinn på vegne av et selskap krever enten en systembruker som selskapet selv oppretter og godkjenner i Altinn for et registrert sluttbrukersystem, eller en person med signaturrett eller riktig rolle som logger inn selv. Begge delene eies av selskapet og av Digdir sine vilkår, og Altinn Servicedesk har etter juridisk vurdering (21. oktober 2026) bekreftet at opplysninger fra Altinn Autorisasjon ikke kan brukes som grunnlag for en kommersiell tjeneste, med eller uten systembruker. Apier formidler derfor ingen systembruker, sjekker ingen fullmakt i Altinn og sender ikke inn skjemaer. Apier tilbyr ikke innsending av MVA-melding; den linjen er satt på vent.
Hvorfor en MCP-server i stedet for å lære agenten min å tolke signaturrett selv?
Signaturrett står som fritekst i Foretaksregisteret, og klausulene varierer fra selskap til selskap: daglig leder alene, to styremedlemmer i fellesskap, styrets leder sammen med ett styremedlem. En agent som tolker friteksten selv gjetter, og gjetningen er verken sporbar eller reproduserbar. Apier returnerer signaturretten kodet som rollekombinasjoner, med klausulteksten ordrett ved siden av og en ufortolket tilstand, hvert svar stemplet med kilde og verifiseringsdato. Samme inndata pluss regelbokversjon gir identisk utdata, byte for byte. Pliktene og fristene kommer som støttelag fra den samme versjonerte regelboken.
Trenger agenten min Maskinporten eller et virksomhetssertifikat for å bruke Apier?
Nei. Signaturrett, prokura, status og roller er åpne registerdata, så agenten din autentiserer mot Apier med én Bearer-API-nøkkel og trenger verken Maskinporten, virksomhetssertifikat eller Altinn-tilgang for noe Apier tilbyr. Trenger virksomheten din Maskinporten eller en systembruker i Altinn til egne, offentlige oppgaver, settes det opp direkte hos Digdir og i Altinn, i virksomhetens eget navn: Apier formidler ikke Maskinporten eller Altinn på vegne av andre.
Les mer
- Signaturrett (company authority): selskapets registrerte signaturregler, kodet, med kilde og verifiseringsdato.
- Altinn API: hva Altinn 3 er, og hvordan en virksomhet får tilgang direkte.
- Maskinporten API: hva Maskinporten er, og hvordan en virksomhet setter det opp selv hos Digdir.
- Brønnøysund (BRREG) API: selskapsoppslag og verifisering.
- Skatteetaten API: hva MVA-meldingen er, og hvem som sender den inn.
- Webhooks API: varsler sendt til deg når registertilstand endres.
- Dokumentasjon og Apier-forsiden.
Kom i gang
MCP-serveren er én npx unna, og sandkassen kan kjøres med curl uten registrering; dokumentasjonen dekker leseverktøyene, scopes og hva som ikke tilbys.