io.github.sedis-ab/mcp

Read-only. Discover the right financial parameter by name fragment or group and return each parameter's `code`, English name, group and description. Use this to resolve the `parameterCode` you then pass to `bolagsanalys_get_data` (alongside a `companyId` from `bolagsanalys_list_companies`). Example: nameContains 'revenue', group 'Income statement'. Shared reference data; read-only — never writes.

Read-only. Fetch quarterly figures for one company — optionally narrowed to a single parameter and a quarter range. Pass a `companyId` from `bolagsanalys_list_companies` and (optionally) a `parameterCode` from `bolagsanalys_find_parameter`. Quarter bounds use packed ids: `quarterId`, `fromDate`, `toDate` accept e.g. '20251' or '2025Q1' (these are QUARTERS, not calendar dates). Example: companyId 'SE-VOLV-B', parameterCode 'REV', fromDate '2024Q1', toDate '2025Q4'. Every row keeps its `companyId` and `parameterCode`; read-only — never writes.

Read-only. Search Sedis's catalog of listed companies by name fragment or country code and return each company's `companyId` and name. This is the FIRST step of the Bolagsanalys flow: take a `companyId` from here and pass it to `bolagsanalys_get_data` to fetch its quarterly figures. Example: nameContains 'Volvo', countryCode 'SE'. Reference data shared across all tenants; this tool never writes or ingests.

Read-only. Fetch quarterly figures for a SPECIFIC SET of companies in one call by passing `companyIds` (up to 50, from `bolagsanalys_list_companies`), optionally narrowed to a `parameterCode` (from `bolagsanalys_find_parameter`) and a quarter range. Use this for a specific N-company subset — v2's GET has no companyIdIn, so to fetch ALL companies instead omit `companyId` on `bolagsanalys_get_data`. Quarter bounds use packed ids: `quarterId`, `fromDate`, `toDate` accept e.g. '20251' or '2025Q1' (QUARTERS, not calendar dates). The cap is 50 — more is rejected. Returns the same envelope as `bolagsanalys_get_data`; every row keeps its `companyId` and `parameterCode`; read-only — never writes.

Forget the locally-cached session token (removes it from memory and the on-disk cache). After this, calls send no X-Api-Session header until you set_session again. Use it to sign out of the current session.

Read-only. Discover the right real-estate benchmark parameter by name fragment or group and return each parameter's `code`, English name, `dataType` (decimal/boolean/enum/date) and — for enum parameters — its `enumValues` legal-value domain. Use this to resolve the `parameterCode` you pass to `fastighetsbenchmark_get_comp_timeseries`, and read `dataType` to know which CompDatum value member to trust. Example: nameContains 'Total return'. Shared reference data; read-only — never writes.

Read-only. Pull the actual benchmarking numbers (CompDatum time-series) for one or more Comps. This is the FINAL step of the §8 A6 flow: pass the `sedisId`s you found (from `fastighetsbenchmark_search_property_units`, `_list_samlingar`'s `containingCompSedisIds`, or `_list_jamforelseobjekt`) as a comma-separated `sedisIdIn`, plus a `parameterCode` from `fastighetsbenchmark_find_parameter` and an ISO date range. Each row is SELF-DESCRIBING via `dataType` (decimal/boolean/enum/date) — read the matching member (`figure`/`boolean`/`enum`/`date`); an enum resolves to `{ value, name, enumType }`, so use `enum.name`, never the raw int. Every row keeps its `sedisId` (do not conflate Comps). Use `count: false` for cheap bulk paging. Example: sedisIdIn 'PU-1,PU-2', parameterCode 'NX71', fromDate '2016-01-01', toDate '2026-12-31'. Tenant-scoped to your data; read-only — never writes.

Read-only. List YOUR comparison zones (Jämförelseobjekt — your clones of a Sedis-owned aggregate), returning each zone's `sedisId`. This is the FIRST step of the §8 A6 flow: find a zone by name here, then pass its `sedisId` to `fastighetsbenchmark_search_property_units` as `belongsToJamforelseobjektSedisId` to find your units in it. Lean by default: set `detail: true` to opt into the tenant-filtered `containsPropertyUnits` lineage. Example: nameContains 'Stockholm'. Tenant-scoped to your data; read-only — never writes.

Read-only. List the SHARED Sedis-owned reference zones — the same for every key, with NO tenant filter (these are not your private data). Each row exposes its `sedisId`, `name`, and `sourceName` (the external-reference provider, e.g. 'Nils Holgersson'). Use a reference zone as a market benchmark to compare against your own comparison zones and property units. Example: nameContains 'Stockholm'. Shared reference data; read-only — never writes.

Read-only. List YOUR collections (Samling). Each row exposes its members as `containingCompSedisIds` — an array of ids, not nested objects — so you can reference-then-resolve: take those ids and pass them to `fastighetsbenchmark_get_comp_timeseries` via `sedisIdIn` only for the collections you actually need (this keeps payloads bounded). Example: nameContains 'Stockholm offices'. Tenant-scoped to your data; read-only — never writes (creating/replacing/deleting a Samling is not exposed here).

Read-only. Find YOUR property units (Fastighet) by name, property-type id, municipality, or comparison-zone membership, returning each unit's `sedisId`. This is the §8 A6 flow's object-finding step: take a comparison zone from `fastighetsbenchmark_list_jamforelseobjekt` and filter here with `belongsToJamforelseobjektSedisId`, then pass the resulting `sedisId`s to `fastighetsbenchmark_get_comp_timeseries` via `sedisIdIn`. Lean by default: geometry is omitted unless you set `includeGeometry: true`. Example: propertyType 1 (Office), belongsToJamforelseobjektSedisId 'JO-A'. Tenant-scoped to your data; read-only — never writes.

Paste the freshly-minted session token from the Sedis reprove page to refresh this session WITHOUT restarting the client. Use this when a tool returns 'Session re-verification required': open the reproveUrl, complete 2FA, copy the new token, call this tool with it, then retry the original call. The token is cached locally (owner-only file) and sent as the X-Api-Session header on every subsequent call; it is never logged or echoed back.