Skip to main content
Glama
@sedis/mcp

@sedis/mcp

Official
by sedis-ab

@sedis/mcp

CI npm version License: MIT Node.js >= 20

A Model Context Protocol (MCP) server that wraps the Sedis PartnerAPI v2 as a small set of curated, read-only tools, so AI assistants and agents (Claude Desktop, Cursor, and any MCP-capable client) can query your Sedis Bolagsanalys (listed-company financials) and Fastighetsbenchmark (real-estate comparables) data in natural language. The server is a thin pass-through: it adds shape and transport only — every tenant-isolation, authentication, rate-limit, and billing rule lives in PartnerAPI v2, not here.

Not a Sedis customer yet? This server requires a Sedis PartnerAPI v2 key — there is no free tier or trial. Get in touch: info@sedis.se · Fråga Sedis

Install

Easiest: one-click Claude Desktop bundle (.mcpb) — recommended

For non-technical users, install the Desktop Extension — a single file, no Node, no JSON, no terminal:

  1. Download sedis-mcp.mcpb from the latest release.

  2. Double-click it (or open Claude Desktop → Settings → Extensions and drag it in) and click Install.

  3. Paste your Sedis API key into the field that appears (stored in your OS keychain) and confirm.

  4. Done — start a chat and ask, e.g. "Visa nyckeltal för Fabege" (lang: "sv" for Swedish).

The bundle packages the exact server described below together with its dependencies; Claude Desktop supplies the Node runtime, so the user installs nothing else. Ask your Sedis administrator for a key — a customer-level (M2M) key needs no per-session two-factor step. Maintainers build the bundle with npm run build:mcpb (output: dist/sedis-mcp.mcpb).

Manual config (any MCP client — Claude Code, Cursor, …)

The server runs over stdio and is launched on demand via npx — no global install needed. The canonical launch command is:

npx -y @sedis/mcp

Add it to your client's MCP config and set your PartnerAPI key:

{
  "mcpServers": {
    "sedis": {
      "command": "npx",
      "args": ["-y", "@sedis/mcp"],
      "env": {
        "SEDIS_API_KEY": "your-partnerapi-v2-key"
      }
    }
  }
}
  • Claude Desktop: add the block above to claude_desktop_config.json.

  • Cursor / other clients: add it to the client's mcp.json (same shape).

Configuration

Env var

Required

Default

Purpose

SEDIS_API_KEY

yes

—

Your PartnerAPI v2 key. Sent only as the X-Api-Key header; never logged.

SEDIS_API_BASE_URL

no

https://api.sedis.se

Override the v2 base URL (e.g. for an alpha/beta environment).

SEDIS_API_SESSION

no

—

Optional startup seed for the session token (user-owned keys only). Sent as X-Api-Session; never logged. Usually you set this at runtime with the set_session tool instead — no restart needed.

The key is validated lazily — the server starts without it and returns a friendly, actionable error on the first tool call if it is missing or invalid. There is no startup ping.

Tools not showing up? MCP servers are loaded when your client starts — after editing the config, fully restart/reload the client (a new chat in the same window is not enough). If you registered it via a CLI (claude mcp add), make sure it landed in the right scope: a server added in one directory isn't visible in another project unless you use a global/user scope.

Session tokens (user-owned keys)

If your key is owned by a specific user (issued to a named person, not a machine/M2M integration key), PartnerAPI v2 requires a short-lived session token alongside X-Api-Key, refreshed periodically via two-factor auth:

  1. On a 401 with reason session_expired / session_invalid, the tool error carries a reproveUrl. Open it in a browser, complete 2FA, and copy the freshly-minted sedis_sess_… token.

  2. Paste it with the set_session tool — it is carried as X-Api-Session on the very next call, no client restart needed. Use clear_session to sign out.

  3. Optionally seed a token at startup with the SEDIS_API_SESSION env var (handy for CI / power users); at runtime set_session always takes precedence.

Machine / org-wide keys (no owner) are headless — X-Api-Key only, no session token, and you never call set_session.

Local development / testing against a non-production environment

To run a local build (unpublished) or point at a non-production environment, swap npx for the built entrypoint and override the base URL:

{
  "mcpServers": {
    "sedis-local": {
      "command": "node",
      "args": ["/absolute/path/to/sedis-mcp/build/index.js"],
      "env": {
        "SEDIS_API_KEY": "your-non-production-key",
        "SEDIS_API_BASE_URL": "https://<your-non-production-host>"
      }
    }
  }
}

Ask the Sedis team for the host name — non-production environments are not publicly documented. This is a development convenience only; production users just use the npx -y @sedis/mcp block above with a single SEDIS_API_KEY, which defaults to https://api.sedis.se.

Related MCP server: sec-edgar-mcp

Tools

All tools are read-only. Tenant scope is enforced by v2: the "YOUR …" tools only ever return data your key is entitled to, and a request for another tenant's object comes back as a friendly not found (never a 403 that would leak existence).

Bolagsanalys (listed-company financials)

Tool

What it does

bolagsanalys_list_companies

Search the catalog of listed companies by name fragment.

bolagsanalys_find_parameter

Discover the right financial parameter by name fragment.

bolagsanalys_get_data

Fetch quarterly figures. Pass one companyId, or omit it to get all companies for a parameter/quarter.

bolagsanalys_search_data

Batch-fetch figures for a specific set of companies — companyIds[] (max 50).

Fastighetsbenchmark (real-estate comparables)

Tool

What it does

fastighetsbenchmark_find_parameter

Discover the right real-estate benchmark parameter by name.

fastighetsbenchmark_search_property_units

Find YOUR property units (Fastighet) by exact name, name fragment, municipality, zone, or property-type name (propertyTypeName, e.g. "Office"/"Kontor").

fastighetsbenchmark_list_samlingar

List YOUR collections (Samling) and their members.

fastighetsbenchmark_list_jamforelseobjekt

List YOUR comparison zones (Jämförelseobjekt).

fastighetsbenchmark_get_comp_timeseries

Pull the actual CompDatum benchmarking time-series (self-describing values).

fastighetsbenchmark_list_reference_zones

List the shared, Sedis-owned market reference zones (same for every key).

fastighetsbenchmark_list_municipalities

Look up municipality ids for the municipalityId filter — by name or official code (e.g. SCB 0180).

fastighetsbenchmark_list_property_types

Look up property-type ids for the propertyType filter (the EB0 domain).

Names and descriptions are English by default; pass lang: "sv" on the parameter-discovery and property-unit tools to get Swedish.

Session (user-owned keys)

Tool

What it does

set_session

Paste a freshly-minted sedis_sess_… token (from the reprove page) — carried as X-Api-Session on the next call, no restart.

clear_session

Forget the current session token (sign out).

These are needed only for user-owned keys (see Session tokens above); machine / org-wide keys never use them.

Errors are mapped from PartnerAPI v2's RFC 7807 problem responses into short, friendly tool errors that carry a traceId for support — and never the API key or a stack trace. If a tool reports a session / two-factor re-verification error, open the reproveUrl in the message, complete 2FA, copy the new sedis_sess_… token, and paste it via the set_session tool — then retry (no client restart). See Session tokens (user-owned keys) above.

API reference

This server is a wrapper. The underlying endpoints, query conventions, multi-tenant isolation model, geometry, error shapes, rate limits, and data freshness are documented in the PartnerAPI v2 guide that Sedis provides with your API key — contact Sedis if you need access. The live OpenAPI description is served at <SEDIS_API_BASE_URL>/openapi/v2.json (default https://api.sedis.se/openapi/v2.json). This README does not duplicate that reference.

Data use

Use of Sedis data in AI/LLM contexts is subject to your Sedis agreement and the accompanying MCP data-use terms. See SECURITY.md for the key-handling and supply-chain posture.

Licence

MIT.

Available Tools

14 tools
bolagsanalys_find_parameterFind a Bolagsanalys parameterA
Read-only

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.

Inputs: lang, page, sort, group, +2 more. Returns: data, page, pageSize, totalCount, +1 more

bolagsanalys_get_dataGet Bolagsanalys quarterly figuresA
Read-only

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.

Inputs: page, sort, count, toDate, +5 more. Returns: data, page, pageSize, totalCount, +1 more

bolagsanalys_list_companiesList listed companies (Bolagsanalys)A
Read-only

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.

Inputs: page, sort, pageSize, countryCode, +1 more. Returns: data, page, pageSize, totalCount, +1 more

bolagsanalys_search_dataSearch Bolagsanalys figures for many companies (batch)A
Read-only

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.

Inputs: page, sort, count, toDate, +6 more. Returns: data, page, pageSize, totalCount, +1 more

clear_sessionClear the cached Sedis session tokenA

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.

Inputs: no named parameters.

fastighetsbenchmark_find_parameterFind a Fastighetsbenchmark parameterA
Read-only

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.

Inputs: lang, page, sort, group, +2 more. Returns: data, page, pageSize, totalCount, +1 more

fastighetsbenchmark_get_comp_timeseriesGet the CompDatum time-seriesA
Read-only

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 sedisIds 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.

Inputs: sedisIdIn (required), page, count, toDate, +3 more. Returns: data, page, pageSize, totalCount, +1 more

fastighetsbenchmark_list_jamforelseobjektList your comparison zones (Jämförelseobjekt)A
Read-only

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.

Inputs: page, sort, detail, pageSize, +1 more. Returns: data, page, pageSize, totalCount, +1 more

fastighetsbenchmark_list_municipalitiesList municipalities (shared)A
Read-only

Read-only. Look up municipality ids — the municipalityId filter of fastighetsbenchmark_search_property_units. Shared reference data, the same for every key. Each row has id, name, countryCode and code (the official municipality code; for Sweden the SCB kommunkod, e.g. '0180'). Example: nameContains 'Stockholm' → id 21. Read-only — never writes.

Inputs: code, page, sort, pageSize, +2 more. Returns: data, page, pageSize, totalCount, +1 more

fastighetsbenchmark_list_property_typesList property types (shared)A
Read-only

Read-only. Look up property-type ids — the propertyType filter of fastighetsbenchmark_search_property_units and the domain of the EB0 parameter. Shared reference data, the same for every key; names are Swedish. Example: nameContains 'Kontor'. Read-only — never writes.

Inputs: page, sort, pageSize, nameContains. Returns: data, page, pageSize, totalCount, +1 more

fastighetsbenchmark_list_reference_zonesList reference zones (shared)A
Read-only

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.

Inputs: page, sort, pageSize, nameContains. Returns: data, page, pageSize, totalCount, +1 more

fastighetsbenchmark_list_samlingarList your collections (Samling)A
Read-only

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).

Inputs: page, sort, pageSize, nameContains. Returns: data, page, pageSize, totalCount, +1 more

fastighetsbenchmark_search_property_unitsSearch your property units (Fastighet)A
Read-only

Read-only. Find YOUR property units (Fastighet) by exact name, name fragment, property-type id, municipality, or comparison-zone membership, returning each unit's sedisId — the stable, case-sensitive key to use in every later call. name is the customer's own designation; an official property designation (fastighetsbeteckning, e.g. 'Klara 1:1') is not a name and is not searchable. Look up property-type and municipality ids with fastighetsbenchmark_list_property_types / fastighetsbenchmark_list_municipalities. 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 sedisIds to fastighetsbenchmark_get_comp_timeseries via sedisIdIn. Lean by default: geometry is omitted unless you set includeGeometry: true. Example: propertyType 2, belongsToJamforelseobjektSedisId 'JO-A'. Tenant-scoped to your data; read-only — never writes.

Inputs: lang, name, page, sort, +7 more. Returns: data, page, pageSize, totalCount, +1 more

set_sessionSet the Sedis session token (after re-proving 2FA)A

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.

Inputs: token (required).

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A4.2/5.0

    Scored across 14 tools

    Disambiguation4/5

    Most tools target clearly distinct resources and steps; the two closest pairs (bolagsanalys_get_data vs bolagsanalys_search_data, and list_jamforelseobjekt vs list_reference_zones) are explicitly differentiated in their descriptions. There is still mild overlap in purpose between the two data-fetch tools, so an agent must read carefully to pick the right one.

    Naming Consistency4/5

    Strong, predictable verb_noun pattern within each domain prefix (fastighetsbenchmark_* and bolagsanalys_*), and the two session tools (set_session/clear_session) are clean and readable. The only deviation is that session tools don't share a domain prefix, but they're a distinct cross-cutting concern so this is a minor issue.

    Tool Count5/5

    14 tools split across two coherent domains (real-estate benchmarking and company analysis) plus session handling is well-scoped. Each tool earns its place as a distinct step in the documented flows, with no redundant or trivial tools.

    Completeness4/5

    Both domains have complete read paths: reference lookups, parameter discovery, object search, and terminal data fetches, plus session lifecycle management. The main gap is the absence of write operations (e.g. creating/editing Samlingar or zones), which is acknowledged as intentional in the descriptions.

    Maintenance

    ActivityActive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      C
      quality
      B
      maintenance
      MCP server for accessing SEC EDGAR filings. Connects AI assistants to company filings, financial statements, and insider trading data with exact numeric precision.
      21
      1,029 PyPI
      388
      AGPL 3.0
    • A
      license
      Not graded
      quality
      D
      maintenance
      Hosted MCP server that gives AI agents real-time access to SEC EDGAR filings search, 10-K/8-K reading, XBRL financial facts, and insider-trade (Form 4) alerts.
      1
      MIT
    • A
      license
      A
      quality
      B
      maintenance
      MCP server for programmatic read-only access to RiseUp cashflow data, allowing AI assistants to retrieve budget information via natural language.
      10
      1,012 npm
      41
      MIT