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

Canonical: https://www.apier.no/no/mcp-verktoy

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øy | Formål og data som returneres | Inndata | Datakilder | Lagringstid | Databehandlere | Kostnad | Autentisering |
|---|---|---|---|---|---|---|---|
| `get_company_summary` | Hvilke plikter og frister som gjelder for selskapet, i ett kall. | `org_number` (påkrevd) | `brreg`, `altinn`, `rulebook` | Inndata og svar i loggen over MCP-kall i 24 måneder, deretter slettet | Vercel, Supabase, Sentry | 50 øre (NOK 0.50) per kall, forhåndsbetalt | API-nøkkel med tilgangen `read:brreg`, eller en sandkassenøkkel (bare testdata) |
| `get_public_obligations` | Hvilke plikter som gjelder for en organisasjonsform, for eksempel AS eller ENK. | `entity_type` (påkrevd) | `rulebook` | Inndata og svar i loggen over MCP-kall i 24 måneder, deretter slettet | Vercel, Supabase, Sentry | Gratis | Ingen: uten nøkkel |
| `get_exchange_rate` | Norges Banks valutakurs for en valuta mot norske kroner. | `base` (påkrevd), `quote` (påkrevd), `date` | `norges_bank` | Inndata og svar i loggen over MCP-kall i 24 måneder, deretter slettet | Vercel, Supabase, Sentry | Gratis | Ingen: uten nøkkel |
| `get_company_profile` | Den strukturerte selskapsprofilen registeret har for et organisasjonsnummer. | `org_number` (påkrevd) | `brreg:enhetsregisteret` | Inndata og svar i loggen over MCP-kall i 24 måneder, deretter slettet | Vercel, Supabase, Sentry | 50 øre (NOK 0.50) per kall, forhåndsbetalt | API-nøkkel med tilgangen `read:brreg` |
| `get_company_context` | Selskapets identitet i registeret: organisasjonsform, status og registreringsfakta. | `org_number` (påkrevd) | `brreg` | Inndata og svar i loggen over MCP-kall i 24 måneder, deretter slettet | Vercel, Supabase, Sentry | 50 øre (NOK 0.50) per kall, forhåndsbetalt | API-nøkkel med tilgangen `read:brreg`, eller en sandkassenøkkel (bare testdata) |
| `get_company_deadlines` | Når selskapets innsendinger forfaller. | `org_number` (påkrevd), `horizon_months` | `rulebook`, `brreg` | Inndata og svar i loggen over MCP-kall i 24 måneder, deretter slettet | Vercel, Supabase, Sentry | 50 øre (NOK 0.50) per kall, forhåndsbetalt | API-nøkkel med tilgangen `read:brreg`, eller en sandkassenøkkel (bare testdata) |
| `get_company_obligations` | Hvilke registrerte plikter som gjelder for selskapet. | `org_number` (påkrevd) | `rulebook`, `brreg` | Inndata og svar i loggen over MCP-kall i 24 måneder, deretter slettet | Vercel, Supabase, Sentry | 50 øre (NOK 0.50) per kall, forhåndsbetalt | API-nøkkel med tilgangen `read:brreg`, eller en sandkassenøkkel (bare testdata) |
| `get_public_deadlines` | Den generelle norske fristkalenderen for et år. | `year` | `rulebook` | Inndata og svar i loggen over MCP-kall i 24 måneder, deretter slettet | Vercel, Supabase, Sentry | Gratis | Ingen: uten nøkkel |
| `explain_compliance_error` | Hva en feilkode fra Apier betyr, og hvordan kallet rettes. | `error_code` (påkrevd), `context_org_number`, `context_scope`, `context_role`, `context_field`, `context_upstream_system` | `explainer:rulebook` | Inndata og svar i loggen over MCP-kall i 24 måneder, deretter slettet | Vercel, Supabase, Sentry | Gratis | Ingen: uten nøkkel |
| `search_companies` | Hvilke organisasjonsnumre som passer til et selskapsnavn. | `name` (påkrevd) | `brreg` | Inndata og svar i loggen over MCP-kall i 24 måneder, deretter slettet | Vercel, Supabase, Sentry | Gratis | API-nøkkel med tilgangen `read:brreg` |
| `get_company_verification` | Om selskapet er registrert og aktivt: pass, warn, fail eller unknown, med flaggene bak statusen. | `org_number` (påkrevd), `mode` | `brreg` | Inndata og svar i loggen over MCP-kall i 24 måneder, deretter slettet | Vercel, Supabase, Sentry | 50 øre (NOK 0.50) per kall, forhåndsbetalt | API-nøkkel med tilgangen `read:brreg`, eller en sandkassenøkkel (bare testdata) |
| `get_company_authority` | Selskapets registrerte signaturregler: signaturrett og prokura. | `org_number` (påkrevd) | `brreg`, `fullmakttjenesten` | Inndata og svar i loggen over MCP-kall i 24 måneder, deretter slettet | Vercel, Supabase, Sentry | 50 øre (NOK 0.50) per kall, forhåndsbetalt | API-nøkkel med tilgangen `read:brreg`, eller en sandkassenøkkel (bare testdata) |
| `get_company_accounts` | Siste øyeblikksbilde av årsregnskapet: innsendingsstatus og nøkkeltall. | `org_number` (påkrevd) | `brreg`, `rulebook` | Inndata og svar i loggen over MCP-kall i 24 måneder, deretter slettet | Vercel, Supabase, Sentry | 50 øre (NOK 0.50) per kall, forhåndsbetalt | API-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_from` | `brreg`, `internal-supabase` | Inndata og svar i loggen over MCP-kall i 24 måneder, deretter slettet | Vercel, Supabase, Sentry | 50 øre (NOK 0.50) per kall, forhåndsbetalt | API-nøkkel med tilgangen `read:brreg`, eller en sandkassenøkkel (bare testdata) |
| `get_company_history` | Tilstanden 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`, `view` | `brreg`, `internal-supabase` | Inndata og svar i loggen over MCP-kall i 24 måneder, deretter slettet | Vercel, Supabase, Sentry | 50 øre (NOK 0.50) per kall, forhåndsbetalt | API-nøkkel med tilgangen `read:brreg`, eller en sandkassenøkkel (bare testdata) |
| `list_changes` | Hvilke endringer Apier har oppdaget i kildene den følger, siden en dato. | `source`, `entity_type`, `entity_id`, `change_type`, `from`, `to`, `limit`, `cursor` | `internal-supabase` | Inndata og svar i loggen over MCP-kall i 24 måneder, deretter slettet | Vercel, Supabase, Sentry | Gratis | API-nøkkel med tilgangen `read:changes` |
| `get_altinn_migration_guidance` | Hvilken ressurs i Altinn 3 som erstattet en tjenestekode eller rollekode i Altinn 2. | `altinn2_code` | `digdir`, `internal-static` | Inndata og svar i loggen over MCP-kall i 24 måneder, deretter slettet | Vercel, Supabase, Sentry | Gratis | Ingen: uten nøkkel |
| `get_pricing` | Hva hvert målte kall koster. | Ingen | `apier:pricing` | Inndata og svar i loggen over MCP-kall i 24 måneder, deretter slettet | Vercel, Supabase, Sentry | Gratis | Ingen: uten nøkkel |
| `get_credit_balance` | Hvor mye forhåndsbetalt kreditt kontoen har igjen. | Ingen | `internal-supabase` | Inndata og svar i loggen over MCP-kall i 24 måneder, deretter slettet | Vercel, Supabase, Sentry | Gratis | API-nøkkel med tilgangen `read:credits` |
| `redeem_issuance_token` | Bytter et engangstoken fra kontoeieren mot agentens egen API-nøkkel. | `token` (påkrevd) | `internal-supabase` | Inndata og svar i loggen over MCP-kall i 24 måneder, deretter slettet; tokenet og den utstedte nøkkelen sladdes før raden skrives | Vercel, Supabase, Sentry | Gratis | Ingen: 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øy | Status |
|---|---|
| `request_fullmakt` | Trukket 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_fullmakt` | Trukket 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_fullmakt` | Trukket 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_capacity` | Trukket 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_authorization` | Trukket 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_action` | Trukket 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_history` | Trukket 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.

## Se også

- [Tillit og databehandling (engelsk)](https://www.apier.no/trust)
- [Personvernerklæring](https://www.apier.no/no/personvern)
- [MCP-serveren](https://www.apier.no/no/mcp-server-norske-selskapsdata)
- [Priser](https://www.apier.no/no/priser)
