Hopp til innhold

Hva hvert MCP-verktøy gjør med data

MCP-serveren til Apier på /api/mcp viser 20 verktøy; 7 av dem krever ingen API-nøkkel. Tabellen viser for hvert verktøy hva det er til, hva det tar imot, hva det returnerer og fra hvilke kilder, hvor lenge Apier tar vare på kallet, hvilke databehandlere som håndterer det, hva det koster og hvordan det autentiseres.

Tabellen er generert fra det samme registeret som serveren svarer tools/list fra, og prisene fra den samme konfigurasjonen som måleren trekker fra, så den stemmer med det klienten din ser. 7 verktøy er trukket tilbake og står for seg nedenfor.

Verktøy

Datakildene er merkene hvert verktøy returnerer i metadata.data_sources, vist slik serveren sender dem. Hvert svar er konvolutten { result, justification, metadata }.

VerktøyFormål og data som returneresInndataDatakilderLagringstidDatabehandlereKostnadAutentisering
get_company_summaryHvilke plikter og frister som gjelder for selskapet, i ett kall.org_number (påkrevd)brreg, altinn, rulebookInndata og svar i loggen over MCP-kall i 24 måneder, deretter slettetVercel, Supabase, Sentry50 øre (NOK 0.50) per kall, forhåndsbetaltAPI-nøkkel med tilgangen read:brreg, eller en sandkassenøkkel (bare testdata)
get_public_obligationsHvilke plikter som gjelder for en organisasjonsform, for eksempel AS eller ENK.entity_type (påkrevd)rulebookInndata og svar i loggen over MCP-kall i 24 måneder, deretter slettetVercel, Supabase, SentryGratisIngen: uten nøkkel
get_exchange_rateNorges Banks valutakurs for en valuta mot norske kroner.base (påkrevd), quote (påkrevd), datenorges_bankInndata og svar i loggen over MCP-kall i 24 måneder, deretter slettetVercel, Supabase, SentryGratisIngen: uten nøkkel
get_company_profileDen strukturerte selskapsprofilen registeret har for et organisasjonsnummer.org_number (påkrevd)brreg:enhetsregisteretInndata og svar i loggen over MCP-kall i 24 måneder, deretter slettetVercel, Supabase, Sentry50 øre (NOK 0.50) per kall, forhåndsbetaltAPI-nøkkel med tilgangen read:brreg
get_company_contextSelskapets identitet i registeret: organisasjonsform, status og registreringsfakta.org_number (påkrevd)brregInndata og svar i loggen over MCP-kall i 24 måneder, deretter slettetVercel, Supabase, Sentry50 øre (NOK 0.50) per kall, forhåndsbetaltAPI-nøkkel med tilgangen read:brreg, eller en sandkassenøkkel (bare testdata)
get_company_deadlinesNår selskapets innsendinger forfaller.org_number (påkrevd), horizon_monthsrulebook, brregInndata og svar i loggen over MCP-kall i 24 måneder, deretter slettetVercel, Supabase, Sentry50 øre (NOK 0.50) per kall, forhåndsbetaltAPI-nøkkel med tilgangen read:brreg, eller en sandkassenøkkel (bare testdata)
get_company_obligationsHvilke registrerte plikter som gjelder for selskapet.org_number (påkrevd)rulebook, brregInndata og svar i loggen over MCP-kall i 24 måneder, deretter slettetVercel, Supabase, Sentry50 øre (NOK 0.50) per kall, forhåndsbetaltAPI-nøkkel med tilgangen read:brreg, eller en sandkassenøkkel (bare testdata)
get_public_deadlinesDen generelle norske fristkalenderen for et år.yearrulebookInndata og svar i loggen over MCP-kall i 24 måneder, deretter slettetVercel, Supabase, SentryGratisIngen: uten nøkkel
explain_compliance_errorHva en feilkode fra Apier betyr, og hvordan kallet rettes.error_code (påkrevd), context_org_number, context_scope, context_role, context_field, context_upstream_systemexplainer:rulebookInndata og svar i loggen over MCP-kall i 24 måneder, deretter slettetVercel, Supabase, SentryGratisIngen: uten nøkkel
search_companiesHvilke organisasjonsnumre som passer til et selskapsnavn.name (påkrevd)brregInndata og svar i loggen over MCP-kall i 24 måneder, deretter slettetVercel, Supabase, SentryGratisAPI-nøkkel med tilgangen read:brreg
get_company_verificationOm selskapet er registrert og aktivt: pass, warn, fail eller unknown, med flaggene bak statusen.org_number (påkrevd), modebrregInndata og svar i loggen over MCP-kall i 24 måneder, deretter slettetVercel, Supabase, Sentry50 øre (NOK 0.50) per kall, forhåndsbetaltAPI-nøkkel med tilgangen read:brreg, eller en sandkassenøkkel (bare testdata)
get_company_authoritySelskapets registrerte signaturregler: signaturrett og prokura.org_number (påkrevd)brreg, fullmakttjenestenInndata og svar i loggen over MCP-kall i 24 måneder, deretter slettetVercel, Supabase, Sentry50 øre (NOK 0.50) per kall, forhåndsbetaltAPI-nøkkel med tilgangen read:brreg, eller en sandkassenøkkel (bare testdata)
get_company_accountsSiste øyeblikksbilde av årsregnskapet: innsendingsstatus og nøkkeltall.org_number (påkrevd)brreg, rulebookInndata og svar i loggen over MCP-kall i 24 måneder, deretter slettetVercel, Supabase, Sentry50 øre (NOK 0.50) per kall, forhåndsbetaltAPI-nøkkel med tilgangen read:brreg, eller en sandkassenøkkel (bare testdata)
get_company_evidence_packÉn signert registrering av det Apier observerte om selskapet.org_number (påkrevd), changes_frombrreg, internal-supabaseInndata og svar i loggen over MCP-kall i 24 måneder, deretter slettetVercel, Supabase, Sentry50 øre (NOK 0.50) per kall, forhåndsbetaltAPI-nøkkel med tilgangen read:brreg, eller en sandkassenøkkel (bare testdata)
get_company_historyTilstanden Apier hadde observert for selskapet på en dato, eller endringene Apier observerte i en periode.org_number (påkrevd), mode (påkrevd), date, from, to, viewbrreg, internal-supabaseInndata og svar i loggen over MCP-kall i 24 måneder, deretter slettetVercel, Supabase, Sentry50 øre (NOK 0.50) per kall, forhåndsbetaltAPI-nøkkel med tilgangen read:brreg, eller en sandkassenøkkel (bare testdata)
list_changesHvilke endringer Apier har oppdaget i kildene den følger, siden en dato.source, entity_type, entity_id, change_type, from, to, limit, cursorinternal-supabaseInndata og svar i loggen over MCP-kall i 24 måneder, deretter slettetVercel, Supabase, SentryGratisAPI-nøkkel med tilgangen read:changes
get_altinn_migration_guidanceHvilken ressurs i Altinn 3 som erstattet en tjenestekode eller rollekode i Altinn 2.altinn2_codedigdir, internal-staticInndata og svar i loggen over MCP-kall i 24 måneder, deretter slettetVercel, Supabase, SentryGratisIngen: uten nøkkel
get_pricingHva hvert målte kall koster.Ingenapier:pricingInndata og svar i loggen over MCP-kall i 24 måneder, deretter slettetVercel, Supabase, SentryGratisIngen: uten nøkkel
get_credit_balanceHvor mye forhåndsbetalt kreditt kontoen har igjen.Ingeninternal-supabaseInndata og svar i loggen over MCP-kall i 24 måneder, deretter slettetVercel, Supabase, SentryGratisAPI-nøkkel med tilgangen read:credits
redeem_issuance_tokenBytter et engangstoken fra kontoeieren mot agentens egen API-nøkkel.token (påkrevd)internal-supabaseInndata og svar i loggen over MCP-kall i 24 måneder, deretter slettet; tokenet og den utstedte nøkkelen sladdes før raden skrivesVercel, Supabase, SentryGratisIngen: uten nøkkel

Verktøy som er trukket tilbake

Disse verktøyene leste eller leverte autorisasjonsdata fra Altinn og ble trukket tilbake etter det skriftlige svaret fra Digdir. De står fortsatt oppført, slik at en agent som fortsatt kaller et av dem, vet hva den får tilbake.

VerktøyStatus
request_fullmaktTrukket tilbake 2026-10-21. Ikke i tools/list. Et tools/call som nevner verktøyet, svarer med feilkonvolutten med metadata.error_code CAPABILITY_WITHDRAWN (ikke en HTTP 410), før autentisering. Ingen data leses; kallet logges uten argumentene.
revoke_fullmaktTrukket tilbake 2026-10-21. Ikke i tools/list. Et tools/call som nevner verktøyet, svarer med feilkonvolutten med metadata.error_code CAPABILITY_WITHDRAWN (ikke en HTTP 410), før autentisering. Ingen data leses; kallet logges uten argumentene.
check_fullmaktTrukket tilbake 2026-10-21. Ikke i tools/list. Et tools/call som nevner verktøyet, svarer med feilkonvolutten med metadata.error_code CAPABILITY_WITHDRAWN (ikke en HTTP 410), før autentisering. Ingen data leses; kallet logges uten argumentene.
list_acting_capacityTrukket tilbake 2026-10-21. Ikke i tools/list. Et tools/call som nevner verktøyet, svarer med feilkonvolutten med metadata.error_code CAPABILITY_WITHDRAWN (ikke en HTTP 410), før autentisering. Ingen data leses; kallet logges uten argumentene.
check_authorizationTrukket tilbake 2026-10-21. Ikke i tools/list. Et tools/call som nevner verktøyet, svarer med feilkonvolutten med metadata.error_code CAPABILITY_WITHDRAWN (ikke en HTTP 410), før autentisering. Ingen data leses; kallet logges uten argumentene.
validate_actionTrukket tilbake 2026-10-21. Ikke i tools/list. Et tools/call som nevner verktøyet, svarer med feilkonvolutten med metadata.error_code CAPABILITY_WITHDRAWN (ikke en HTTP 410), før autentisering. Ingen data leses; kallet logges uten argumentene.
get_company_filing_historyTrukket tilbake 2026-10-21. Ikke i tools/list. Et tools/call som nevner verktøyet, svarer med feilkonvolutten med metadata.error_code CAPABILITY_WITHDRAWN (ikke en HTTP 410), før autentisering. Ingen data leses; kallet logges uten argumentene.

Slik leser du tabellen

  • Lagringstiden er perioden personvernerklæringen oppgir for loggen over MCP-kall, som inneholder inndata og svar for hvert kall. Logger over API-forespørsler har sin egen, kortere periode; personvernerklæringen viser begge.
  • Databehandlerne er rader i tabellen over databehandlere på tillitssiden: Vercel kjører serveren, Supabase lagrer loggen over MCP-kall, kontoen og arkivet, og Sentry mottar feil. Registrene et verktøy leser fra, er datakilder og ikke databehandlere.
  • Et målt kall betales fra en forhåndsbetalt lommebok. Beløpet refunderes når svaret er en serverfeil (5xx), 403, 404, 410 eller 304; et kall som avvises fordi kredittsaldoen er for lav (INSUFFICIENT_CREDITS), belastes aldri, og en 400 etter belastningen, for eksempel en valideringsfeil, refunderes ikke. Verktøyet get_pricing og GET /api/v1/pricing gir gjeldende prisliste.
  • En sandkassenøkkel (apier_sandbox_test_<suffix>) kjører verktøyene som har et speil med testdata, bare mot syntetiske testdata, og belastes aldri.
  • Ingen verktøy gir et ja eller nei om signaturrett eller etterlevelse: hvert verktøy returnerer fakta og kildene deres. Apier leverer ikke innsendinger til det offentlige.