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.
| Tool | Purpose and data returned | Inputs | Data sources | Retention | Subprocessors | Cost | Authentication |
|---|---|---|---|---|---|---|---|
get_company_summary | Which obligations and deadlines apply to this company, in one call. | org_number (required) | brreg, altinn, rulebook | Inputs and answer in the MCP query log for 24 months, then deleted | Vercel, Supabase, Sentry | 50 øre (NOK 0.50) per call, prepaid | API key with scope read:brreg, or a sandbox bearer (fixtures only) |
get_public_obligations | Which obligations apply to a legal form such as AS or ENK. | entity_type (required) | rulebook | Inputs and answer in the MCP query log for 24 months, then deleted | Vercel, Supabase, Sentry | Free | None: keyless |
get_exchange_rate | Norges Bank's exchange rate for a currency against the Norwegian krone. | base (required), quote (required), date | norges_bank | Inputs and answer in the MCP query log for 24 months, then deleted | Vercel, Supabase, Sentry | Free | None: keyless |
get_company_profile | The structured company profile the register holds for an organisation number. | org_number (required) | brreg:enhetsregisteret | Inputs and answer in the MCP query log for 24 months, then deleted | Vercel, Supabase, Sentry | 50 øre (NOK 0.50) per call, prepaid | API key with scope read:brreg |
get_company_context | The company's register identity: legal form, status and registration facts. | org_number (required) | brreg | Inputs and answer in the MCP query log for 24 months, then deleted | Vercel, Supabase, Sentry | 50 øre (NOK 0.50) per call, prepaid | API key with scope read:brreg, or a sandbox bearer (fixtures only) |
get_company_deadlines | When this company's filings fall due. | org_number (required), horizon_months | rulebook, brreg | Inputs and answer in the MCP query log for 24 months, then deleted | Vercel, Supabase, Sentry | 50 øre (NOK 0.50) per call, prepaid | API key with scope read:brreg, or a sandbox bearer (fixtures only) |
get_company_obligations | Which registered obligations apply to this company. | org_number (required) | rulebook, brreg | Inputs and answer in the MCP query log for 24 months, then deleted | Vercel, Supabase, Sentry | 50 øre (NOK 0.50) per call, prepaid | API key with scope read:brreg, or a sandbox bearer (fixtures only) |
get_public_deadlines | The general Norwegian filing calendar for a year. | year | rulebook | Inputs and answer in the MCP query log for 24 months, then deleted | Vercel, Supabase, Sentry | Free | None: keyless |
explain_compliance_error | What 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_system | explainer:rulebook | Inputs and answer in the MCP query log for 24 months, then deleted | Vercel, Supabase, Sentry | Free | None: keyless |
search_companies | Which organisation numbers match a company name. | name (required) | brreg | Inputs and answer in the MCP query log for 24 months, then deleted | Vercel, Supabase, Sentry | Free | API key with scope read:brreg |
get_company_verification | Whether the company is registered and active: pass, warn, fail or unknown, with the flags behind the status. | org_number (required), mode | brreg | Inputs and answer in the MCP query log for 24 months, then deleted | Vercel, Supabase, Sentry | 50 øre (NOK 0.50) per call, prepaid | API key with scope read:brreg, or a sandbox bearer (fixtures only) |
get_company_authority | The register's coded signing rules for the company: signaturrett and prokura. | org_number (required) | brreg, fullmakttjenesten | Inputs and answer in the MCP query log for 24 months, then deleted | Vercel, Supabase, Sentry | 50 øre (NOK 0.50) per call, prepaid | API key with scope read:brreg, or a sandbox bearer (fixtures only) |
get_company_accounts | The latest annual accounts snapshot: filing status and key figures. | org_number (required) | brreg, rulebook | Inputs and answer in the MCP query log for 24 months, then deleted | Vercel, Supabase, Sentry | 50 øre (NOK 0.50) per call, prepaid | API key with scope read:brreg, or a sandbox bearer (fixtures only) |
get_company_evidence_pack | One signed record of what Apier observed about the company. | org_number (required), changes_from | brreg, internal-supabase | Inputs and answer in the MCP query log for 24 months, then deleted | Vercel, Supabase, Sentry | 50 øre (NOK 0.50) per call, prepaid | API key with scope read:brreg, or a sandbox bearer (fixtures only) |
get_company_history | The 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, view | brreg, internal-supabase | Inputs and answer in the MCP query log for 24 months, then deleted | Vercel, Supabase, Sentry | 50 øre (NOK 0.50) per call, prepaid | API key with scope read:brreg, or a sandbox bearer (fixtures only) |
list_changes | Which changes Apier has detected in the sources it polls, since a date. | source, entity_type, entity_id, change_type, from, to, limit, cursor | internal-supabase | Inputs and answer in the MCP query log for 24 months, then deleted | Vercel, Supabase, Sentry | Free | API key with scope read:changes |
get_altinn_migration_guidance | Which Altinn 3 resource replaced an Altinn 2 service or role code. | altinn2_code | digdir, internal-static | Inputs and answer in the MCP query log for 24 months, then deleted | Vercel, Supabase, Sentry | Free | None: keyless |
get_pricing | What each metered call costs. | None | apier:pricing | Inputs and answer in the MCP query log for 24 months, then deleted | Vercel, Supabase, Sentry | Free | None: keyless |
get_credit_balance | How much prepaid credit the account has left. | None | internal-supabase | Inputs and answer in the MCP query log for 24 months, then deleted | Vercel, Supabase, Sentry | Free | API key with scope read:credits |
redeem_issuance_token | Exchanges a one-time token from the account owner for the agent's own API key. | token (required) | internal-supabase | Inputs and answer in the MCP query log for 24 months, then deleted; the token and the issued key are redacted before the row is written | Vercel, Supabase, Sentry | Free | None: 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.
| Tool | Status |
|---|---|
request_fullmakt | Withdrawn 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_fullmakt | Withdrawn 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_fullmakt | Withdrawn 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_capacity | Withdrawn 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_authorization | Withdrawn 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_action | Withdrawn 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_history | Withdrawn 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.