Skip to content

What each MCP tool does with data

The Apier MCP server at /api/mcp lists 20 tools; 7 of them need no API key. This table says, for each one, what it is for, what it takes, what it returns and from which sources, how long Apier keeps the call, which subprocessors handle it, what it costs and how it authenticates.

The table is generated from the same registry the server answers tools/list from, and the prices from the same configuration the meter debits from, so it matches what your client sees. 7 tools were withdrawn and are listed separately below.

Tools

Data sources are the labels each tool returns in metadata.data_sources, shown as the server sends them. Every answer is the { result, justification, metadata } envelope.

ToolPurpose and data returnedInputsData sourcesRetentionSubprocessorsCostAuthentication
get_company_summaryWhich obligations and deadlines apply to this company, in one call.org_number (required)brreg, altinn, rulebookInputs and answer in the MCP query log for 24 months, then deletedVercel, Supabase, Sentry50 øre (NOK 0.50) per call, prepaidAPI key with scope read:brreg, or a sandbox bearer (fixtures only)
get_public_obligationsWhich obligations apply to a legal form such as AS or ENK.entity_type (required)rulebookInputs and answer in the MCP query log for 24 months, then deletedVercel, Supabase, SentryFreeNone: keyless
get_exchange_rateNorges Bank's exchange rate for a currency against the Norwegian krone.base (required), quote (required), datenorges_bankInputs and answer in the MCP query log for 24 months, then deletedVercel, Supabase, SentryFreeNone: keyless
get_company_profileThe structured company profile the register holds for an organisation number.org_number (required)brreg:enhetsregisteretInputs and answer in the MCP query log for 24 months, then deletedVercel, Supabase, Sentry50 øre (NOK 0.50) per call, prepaidAPI key with scope read:brreg
get_company_contextThe company's register identity: legal form, status and registration facts.org_number (required)brregInputs and answer in the MCP query log for 24 months, then deletedVercel, Supabase, Sentry50 øre (NOK 0.50) per call, prepaidAPI key with scope read:brreg, or a sandbox bearer (fixtures only)
get_company_deadlinesWhen this company's filings fall due.org_number (required), horizon_monthsrulebook, brregInputs and answer in the MCP query log for 24 months, then deletedVercel, Supabase, Sentry50 øre (NOK 0.50) per call, prepaidAPI key with scope read:brreg, or a sandbox bearer (fixtures only)
get_company_obligationsWhich registered obligations apply to this company.org_number (required)rulebook, brregInputs and answer in the MCP query log for 24 months, then deletedVercel, Supabase, Sentry50 øre (NOK 0.50) per call, prepaidAPI key with scope read:brreg, or a sandbox bearer (fixtures only)
get_public_deadlinesThe general Norwegian filing calendar for a year.yearrulebookInputs and answer in the MCP query log for 24 months, then deletedVercel, Supabase, SentryFreeNone: keyless
explain_compliance_errorWhat an Apier error code means and how to correct the call.error_code (required), context_org_number, context_scope, context_role, context_field, context_upstream_systemexplainer:rulebookInputs and answer in the MCP query log for 24 months, then deletedVercel, Supabase, SentryFreeNone: keyless
search_companiesWhich organisation numbers match a company name.name (required)brregInputs and answer in the MCP query log for 24 months, then deletedVercel, Supabase, SentryFreeAPI key with scope read:brreg
get_company_verificationWhether the company is registered and active: pass, warn, fail or unknown, with the flags behind the status.org_number (required), modebrregInputs and answer in the MCP query log for 24 months, then deletedVercel, Supabase, Sentry50 øre (NOK 0.50) per call, prepaidAPI key with scope read:brreg, or a sandbox bearer (fixtures only)
get_company_authorityThe register's coded signing rules for the company: signaturrett and prokura.org_number (required)brreg, fullmakttjenestenInputs and answer in the MCP query log for 24 months, then deletedVercel, Supabase, Sentry50 øre (NOK 0.50) per call, prepaidAPI key with scope read:brreg, or a sandbox bearer (fixtures only)
get_company_accountsThe latest annual accounts snapshot: filing status and key figures.org_number (required)brreg, rulebookInputs and answer in the MCP query log for 24 months, then deletedVercel, Supabase, Sentry50 øre (NOK 0.50) per call, prepaidAPI key with scope read:brreg, or a sandbox bearer (fixtures only)
get_company_evidence_packOne signed record of what Apier observed about the company.org_number (required), changes_frombrreg, internal-supabaseInputs and answer in the MCP query log for 24 months, then deletedVercel, Supabase, Sentry50 øre (NOK 0.50) per call, prepaidAPI key with scope read:brreg, or a sandbox bearer (fixtures only)
get_company_historyThe state Apier had observed for the company on a date, or the changes it observed in a period.org_number (required), mode (required), date, from, to, viewbrreg, internal-supabaseInputs and answer in the MCP query log for 24 months, then deletedVercel, Supabase, Sentry50 øre (NOK 0.50) per call, prepaidAPI key with scope read:brreg, or a sandbox bearer (fixtures only)
list_changesWhich changes Apier has detected in the sources it polls, since a date.source, entity_type, entity_id, change_type, from, to, limit, cursorinternal-supabaseInputs and answer in the MCP query log for 24 months, then deletedVercel, Supabase, SentryFreeAPI key with scope read:changes
get_altinn_migration_guidanceWhich Altinn 3 resource replaced an Altinn 2 service or role code.altinn2_codedigdir, internal-staticInputs and answer in the MCP query log for 24 months, then deletedVercel, Supabase, SentryFreeNone: keyless
get_pricingWhat each metered call costs.Noneapier:pricingInputs and answer in the MCP query log for 24 months, then deletedVercel, Supabase, SentryFreeNone: keyless
get_credit_balanceHow much prepaid credit the account has left.Noneinternal-supabaseInputs and answer in the MCP query log for 24 months, then deletedVercel, Supabase, SentryFreeAPI key with scope read:credits
redeem_issuance_tokenExchanges a one-time token from the account owner for the agent's own API key.token (required)internal-supabaseInputs and answer in the MCP query log for 24 months, then deleted; the token and the issued key are redacted before the row is writtenVercel, Supabase, SentryFreeNone: keyless

Withdrawn tools

These tools read or served Altinn authorisation data and were withdrawn after Digdir's written answer. They stay listed so an agent that still calls one knows what it gets back.

ToolStatus
request_fullmaktWithdrawn on 2026-10-21. Not in tools/list. A tools/call naming it answers the error envelope with metadata.error_code CAPABILITY_WITHDRAWN (not an HTTP 410), before authentication. No data is read; the call is logged without its arguments.
revoke_fullmaktWithdrawn on 2026-10-21. Not in tools/list. A tools/call naming it answers the error envelope with metadata.error_code CAPABILITY_WITHDRAWN (not an HTTP 410), before authentication. No data is read; the call is logged without its arguments.
check_fullmaktWithdrawn on 2026-10-21. Not in tools/list. A tools/call naming it answers the error envelope with metadata.error_code CAPABILITY_WITHDRAWN (not an HTTP 410), before authentication. No data is read; the call is logged without its arguments.
list_acting_capacityWithdrawn on 2026-10-21. Not in tools/list. A tools/call naming it answers the error envelope with metadata.error_code CAPABILITY_WITHDRAWN (not an HTTP 410), before authentication. No data is read; the call is logged without its arguments.
check_authorizationWithdrawn on 2026-10-21. Not in tools/list. A tools/call naming it answers the error envelope with metadata.error_code CAPABILITY_WITHDRAWN (not an HTTP 410), before authentication. No data is read; the call is logged without its arguments.
validate_actionWithdrawn on 2026-10-21. Not in tools/list. A tools/call naming it answers the error envelope with metadata.error_code CAPABILITY_WITHDRAWN (not an HTTP 410), before authentication. No data is read; the call is logged without its arguments.
get_company_filing_historyWithdrawn on 2026-10-21. Not in tools/list. A tools/call naming it answers the error envelope with metadata.error_code CAPABILITY_WITHDRAWN (not an HTTP 410), before authentication. No data is read; the call is logged without its arguments.

How to read the table

  • Retention is the privacy policy's period for the MCP tool query log, which holds each call's inputs and answer. API request logs have their own, shorter period; the privacy policy lists both.
  • The subprocessors are rows of the subprocessor table on the trust page: Vercel runs the server, Supabase holds the query log, the account and the archive, and Sentry receives errors. The registers a tool reads from are data sources, not subprocessors.
  • A metered call is paid from a prepaid wallet. The charge is refunded when the answer is a server error (5xx), 403, 404, 410 or 304; a call refused for too little credit (INSUFFICIENT_CREDITS) is never charged, and a 400 after the charge, such as a validation error, stays charged. The get_pricing tool and GET /api/v1/pricing give the current price list.
  • A sandbox bearer (apier_sandbox_test_<suffix>) runs the tools that have a fixture mirror against synthetic fixtures only, and is never charged.
  • No tool gives a yes or no verdict on signing authority or compliance: each returns facts and their sources. Apier does not submit filings to government.