Skip to main content
Glama
Apiverket MCP Server

Apiverket MCP Server

by vinvuk

Apiverket MCP Server

An MCP (Model Context Protocol) server that gives AI assistants access to Swedish public data through the Apiverket API. It works with Claude Code, Claude Desktop, Cursor, VS Code, Gemini CLI-style MCP clients, and other MCP-compatible tools.

What it does

Tool

Purpose

govdata_discover

Search and browse supported Apiverket endpoints before choosing a path

govdata_query

Call a discovered endpoint and return structured JSON or recovery guidance

govdata_account

Inspect sanitized key mode, tier, daily usage, company-search/company-lookup quota, and upgrade-relevant limits

Agents should call govdata_discover before govdata_query instead of guessing /v1 paths. After a 429 or when a user asks about limits, agents should call govdata_account.

Related MCP server: SCB MCP Server

How Agents Should Use Apiverket

  1. Discover: call govdata_discover with the user's topic, not a guessed path.

  2. Check context: call govdata_account for quota, tier, and production-readiness questions.

  3. Query: call govdata_query only with a supported endpoint returned by discovery.

  4. Recover: if a request fails, use the structured recovery guidance before retrying.

Discovery includes family workflows for transport, weather, geography, municipalities, jobs, government, culture, education, tourism, environment, and company data. These workflows explain search/list/detail patterns, required codes, coordinates, date formats, pagination, and common recovery steps.

Quick Start

Claude Code / Claude Desktop

{
  "mcpServers": {
    "apiverket": {
      "command": "npx",
      "args": ["-y", "apiverket-mcp-server"],
      "env": {
        "GOVDATA_API_URL": "https://apiverket.se",
        "GOVDATA_API_KEY": "sk_test_demo"
      }
    }
  }
}

Cursor / VS Code

{
  "servers": {
    "apiverket": {
      "command": "npx",
      "args": ["-y", "apiverket-mcp-server"],
      "env": {
        "GOVDATA_API_URL": "https://apiverket.se",
        "GOVDATA_API_KEY": "sk_test_demo"
      }
    }
  }
}

Gemini CLI-Style MCP Config

{
  "mcpServers": {
    "apiverket": {
      "command": "npx",
      "args": ["-y", "apiverket-mcp-server"],
      "env": {
        "GOVDATA_API_URL": "https://apiverket.se",
        "GOVDATA_API_KEY": "sk_test_demo"
      }
    }
  }
}

Keys And Limits

Variable

Default

Description

GOVDATA_API_URL

https://apiverket.se

Apiverket API base URL

GOVDATA_API_KEY

sk_test_demo

Sandbox key by default. Use a sk_live_* key from Apiverket for real production data.

sk_test_demo is for setup and safe sandbox responses. It is useful for checking that your MCP client is wired correctly, but production workflows should use a live key. Free live keys are good for exploration; upgrade when daily API or company-search limits block a real workflow.

Company Data With Agents

Company search and company lookup have different jobs:

  1. Use govdata_discover(query: "company") to find the supported company endpoints.

  2. Use /v1/companies/search when the user only has a company name or uncertain organisation number.

  3. Cache the returned org_number.

  4. Use /v1/companies/{orgNumber} for repeated enrichment and automation.

  5. If company search returns 429, stop retrying until reset_at; use lookup when org numbers are already known.

Company search and live company lookup have separate daily quota context by tier. govdata_account shows the configured key tier, remaining company-search quota, remaining company-lookup quota, reset time, and available upgrade tiers. Apiverket does not expose company board, officer, owner, or UBO subresource paths through the company API.

Common Family Workflows

Family

Good first query

Agent workflow

Transport

govdata_discover(query: "train departures")

Use station codes for /v1/transport/trains/{station}; use stop IDs for /v1/transit/departures; list datasets before transport statistics.

Weather

govdata_discover(query: "weather forecast")

Use city endpoints for simple weather, warnings for national alerts, and station/lat/lon flows for air quality or observations.

Geography & municipalities

govdata_discover(query: "municipality population")

Find official municipality/county/place codes first; search KPIs before municipality KPI detail calls; request geometry only when needed.

Jobs

govdata_discover(query: "jobs taxonomy")

Use /v1/jobs/search for ordinary search; use taxonomy types/concepts/autocomplete for controlled filters.

Government & safety

govdata_discover(query: "parliament documents")

Choose calendar, documents, members, committees, SFS, SOU, police events, or police stations based on the question.

Culture, education & environment

govdata_discover(query: "school search")

Search first, then reuse returned IDs/codes for detail endpoints; ensure q, municipality, type, or coordinates are present.

Tool Examples

# Discover endpoints
govdata_discover(query: "electricity prices")
govdata_discover(category: "Weather & Climate")
govdata_discover(query: "train departures")
govdata_discover(query: "municipality KPI")
govdata_discover(query: "jobs taxonomy")

# Query data after discovery
govdata_query(endpoint: "/v1/weather/{city}", path_params: {city: "stockholm"})
govdata_query(endpoint: "/v1/transport/trains/{station}", path_params: {station: "Cst"})
govdata_query(endpoint: "/v1/jobs/search", query_params: {q: "developer", limit: 5})
govdata_query(endpoint: "/v1/taxonomy/types")
govdata_query(endpoint: "/v1/companies/search", query_params: {q: "volvo", limit: 10})
govdata_query(endpoint: "/v1/companies/{orgNumber}", path_params: {orgNumber: "5560125790"})

# Inspect tier and quota state
govdata_account()

Build From Source

git clone https://github.com/vinvuk/apiverket-mcp.git
cd apiverket-mcp
npm install
npm run build

How It Works

  1. The MCP server runs locally over stdio.

  2. govdata_discover searches the built-in endpoint catalog without an API call.

  3. govdata_query calls Apiverket with the configured API key.

  4. Structured API errors are turned into recovery guidance for agents.

  5. Large responses are truncated with pagination guidance.

Requirements

  • Node.js >= 18

  • An Apiverket API key, or sk_test_demo for sandbox setup

License

MIT

Available Tools

2 tools
govdata_discoverDiscover Apiverket EndpointsA
Read-onlyIdempotent

Search and browse available Swedish government data endpoints in the Apiverket API.

Use this tool to find the right endpoint before calling govdata_query. The API covers 139 endpoints across 16 categories including weather, transport, economy, health, environment, parliament, police, education, and more.

Args:

  • query (string, optional): Keyword to search across endpoint names, descriptions, and paths

  • category (string, optional): Filter by category name

When called with no arguments, returns all available categories with endpoint counts.

Examples:

  • Find weather endpoints: query="weather"

  • Browse transport category: category="Transport"

  • Find pension info: query="pension"

  • List all categories: (no arguments)

Returns: Matching endpoints with their paths, parameters, and descriptions.

Inputs: query, category.

govdata_queryQuery Apiverket APIA
Read-onlyIdempotent

Call any Apiverket API endpoint to retrieve Swedish government data.

Use govdata_discover first to find the right endpoint path and required parameters. Then call this tool with the endpoint path and any path/query parameters.

Args:

  • endpoint (string, required): The API path (e.g. "/v1/weather/{city}")

  • path_params (object, optional): Values for path parameters like {city}, {code}, {id}

  • query_params (object, optional): Query string parameters (q, limit, offset, lat, lon, etc.)

Examples:

  • Current weather in Stockholm: endpoint="/v1/weather/{city}", path_params={"city": "stockholm"}

  • Search jobs: endpoint="/v1/jobs/search", query_params={"q": "developer", "limit": 5}

  • Train departures from Stockholm Central: endpoint="/v1/transport/trains/{station}", path_params={"station": "Cst"}

  • Exchange rates: endpoint="/v1/rates"

  • Population by municipality: endpoint="/v1/population/{municipalityCode}", path_params={"municipalityCode": "0180"}

  • Police events in Stockholm: endpoint="/v1/police/events", query_params={"location": "Stockholm", "limit": 10}

  • Find EV chargers near a location: endpoint="/v1/infrastructure/ev-chargers", query_params={"lat": 59.33, "lon": 18.07}

Returns: The API response as JSON, containing a "meta" envelope with request info and a "data" object with the actual data.

Error handling:

  • Returns clear error messages if the API is unreachable, the endpoint doesn't exist, or parameters are invalid

  • Large responses are automatically truncated with pagination guidance

Inputs: endpoint (required), path_params, query_params.

Tool Schema Changelog

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

Loading tool schema changelog…

    TDQS

    A4.5/5.0

    Scored across 2 tools

    Disambiguation5/5

    The two tools serve clearly distinct purposes: govdata_discover for exploring available endpoints and govdata_query for retrieving data. No functional overlap exists.

    Naming Consistency5/5

    Both tools follow a consistent govdata_verb pattern using snake_case, making their purpose predictable.

    Tool Count3/5

    With only 2 tools for a domain covering 139 endpoints across 16 categories, the count is minimal but appropriate for the discover-query pattern. However, it may feel thin for the broad scope.

    Completeness4/5

    The pair covers the complete lifecycle: discovery then retrieval. For a read-only government data API, this is sufficient. Minor gaps like built-in pagination handling are mitigated by error messages.

    Maintenance

    ActivityInactive
    ResponsivenessOutdated data

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      D
      maintenance
      Provides access to Sweden's comprehensive municipal and regional statistics database with semantic search capabilities. Enables natural language queries against thousands of Key Performance Indicators covering various aspects of Swedish public sector data.
      16
      Apache 2.0
    • A
      license
      Not graded
      quality
      D
      maintenance
      Enables LLMs to search, access, and retrieve official Swedish statistics from Statistics Sweden (SCB), providing access to 1,200+ tables covering demographics, economy, environment, labor market, and education with 75+ years of historical data.
      9
      MIT