Swiss Efv MCP server

🇨🇭 Part of the Swiss Public Data MCP Portfolio — open-source MCP servers connecting AI agents to Swiss public and open data.

This is a private project. It is independent of any employer or institutional affiliation.

🏛️ swiss-efv-mcp

MCP server for Swiss federal finances (EFV): budget, debt, forecasts and spending by task and institution.

🇩🇪 Deutsche Version

Overview

This server closes the fiscal gap in the portfolio's Economics & Finance cluster. swiss-snb-mcp already covers monetary policy; swiss-efv-mcp adds the state budget — federal revenue, expenditure, balance, debt ratios (with forecasts to 2029), a hierarchical budget drill-down, and spending by department. Data comes from the Eidgenössische Finanzverwaltung (EFV) via opendata.swiss (OGD Schweiz).

Features

(FS / GFS); every point carries is_projection so actuals and plan/forecast years are unambiguous.

• Five read-only tools over the curated EFV FS/GFS dump files.
• Headline series 1990–2029 per household (bund, ktn, gdn, staat, sv) and model

backoff (2/4/8 s); dump_status never returns empty silently.

• Hierarchical federal-budget drill-down and spending by department / unit.
• 24 h TTL in-memory cache with stale-serve fallback; retry with exponential

• Dual transport: stdio (local) and SSE (cloud).
• No authentication required — public open-government data (No-Auth-First).

🎯 Anchor Demo Query

*"How has the federal balance developed since the SNB rate turnaround in 2022 —

and which task areas absorbed the growth in spending?"*

fiscal_headline(variable="saldo", household="bund", year_from=2021)
fiscal_budget_breakdown(topic="Ausgaben nach Aufgabengebiet", level=2)

Cross-read with swiss-snb-mcp, this connects the interest-rate cycle to the federal deficit — something neither server can answer alone.

Demo

Prerequisites

• Python 3.11+
• uv / uvx (recommended) or pip
• Network access to data.finance.admin.ch and efv.admin.ch — no API key needed

Installation

uvx swiss-efv-mcp            # zero-install run (once published to PyPI)
# or
pip install swiss-efv-mcp

Claude Desktop (claudedesktopconfig.json):

{
  "mcpServers": {
    "swiss-efv": {
      "command": "uvx",
      "args": ["swiss-efv-mcp"]
    }
  }
}

Quickstart

# Run locally over stdio (default transport)
uvx swiss-efv-mcp

# From a checkout, without installing
PYTHONPATH=src python -m swiss_efv_mcp

Configuration

All configuration is loaded once into a typed Settings object (pydantic-settings). The legacy unprefixed names below keep working; the canonical names use the EFVMCP prefix. Defaults are safe for local use.

Shortened. The full README is on GitHub.