Skip to main content

๐Ÿ‡จ๐Ÿ‡ญ Part of the Swiss Public Data MCP Portfolio

๐Ÿ’ผ SECO Labor Market MCP Server

CI PyPI Python 3.11+ MCP No Auth Required License: MIT

๐ŸŒ English | Deutsch

An MCP (Model Context Protocol) server for Swiss labor market data from SECO (Staatssekretariat fรผr Wirtschaft) and AMSTAT via opendata.swiss.

Demo: Claude queries youth unemployment via seco-labor-mcp tool call


Overview

This server connects AI models to Swiss labor market statistics โ€” unemployment rates, job seekers, open positions, youth unemployment, and occupational breakdowns โ€” all without requiring an API key.

Primary audiences:

  • ๐Ÿซ Schulamt / Education planning โ€” youth unemployment, vocational guidance data
  • ๐Ÿ“Š Research & analysis โ€” labor market trends, cantonal comparisons
  • ๐Ÿค– AI agents โ€” automated labor market monitoring and reporting

Anchor query:
"Welche Berufsgruppen haben im Kanton Zรผrich die hรถchste Jugendarbeitslosigkeit, und welche Lehrberufe unterliegen der Stellenmeldepflicht?" โ†’ More use cases by audience โ†’


Data Sources (Phase 1 โ€” No Auth Required)

Source Description Status
opendata.swiss CKAN metadata catalog with SECO dataset CSVs โœ… Live
arbeit.swiss Monthly press reports (PDF, structured URL pattern) โœ… Live
amstat.ch AMSTAT reference portal โš ๏ธ JavaScript SPA, no public REST API

Architecture

โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”
โ”‚                  seco-labor-mcp                     โ”‚
โ”‚                                                     โ”‚
โ”‚  โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”    โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”   โ”‚
โ”‚  โ”‚  FastMCP    โ”‚    โ”‚      9 MCP Tools         โ”‚   โ”‚
โ”‚  โ”‚  Server     โ”‚โ—„โ”€โ”€โ–บโ”‚  seco_search_datasets    โ”‚   โ”‚
โ”‚  โ”‚  (stdio /   โ”‚    โ”‚  seco_get_dataset        โ”‚   โ”‚
โ”‚  โ”‚   SSE)      โ”‚    โ”‚  seco_get_unemployment_* โ”‚   โ”‚
โ”‚  โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜    โ”‚  seco_get_youth_*        โ”‚   โ”‚
โ”‚         โ”‚           โ”‚  seco_get_job_seekers    โ”‚   โ”‚
โ”‚         โ–ผ           โ”‚  seco_get_open_positions โ”‚   โ”‚
โ”‚  โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”    โ”‚  seco_get_monthly_url    โ”‚   โ”‚
โ”‚  โ”‚  httpx      โ”‚    โ”‚  seco_list_cantons       โ”‚   โ”‚
โ”‚  โ”‚  async      โ”‚    โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜   โ”‚
โ”‚  โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”ฌโ”€โ”€โ”€โ”€โ”€โ”€โ”˜                                   โ”‚
โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”ผโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜
          โ”‚
          โ–ผ
  โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”
  โ”‚  opendata.swiss CKAN API          โ”‚
  โ”‚  https://opendata.swiss/api/3/    โ”‚
  โ”‚  action/package_search            โ”‚
  โ”‚  action/package_show              โ”‚
  โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”ฌโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜
              โ”‚
              โ–ผ
  โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”
  โ”‚  SECO Data Resources              โ”‚
  โ”‚  CSV / XLSX / PDF Downloads       โ”‚
  โ”‚  (monthly labor market data)      โ”‚
  โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜

Tools

Tool Description Key Use Case
seco_search_datasets Search SECO datasets on opendata.swiss Discovery
seco_get_dataset Full metadata + download links for a dataset Data access
seco_get_unemployment_overview National/cantonal unemployment figures Labor market overview
seco_get_youth_unemployment Youth unemployment (15โ€“24 year olds) ๐ŸŽ“ Berufswahlberatung
seco_get_job_seekers Stellensuchende (broader than unemployed) Training demand
seco_get_open_positions Open positions โ€” leading indicator Sector analysis
seco_get_unemployment_by_occupation Breakdown by Berufshauptgruppe ๐ŸŽ“ Vocational guidance
seco_get_monthly_report_url Generate/verify PDF report URL Source access
seco_list_cantons All 26 canton codes and names Utility

Installation

Claude Desktop (stdio)

Add to claude_desktop_config.json:

{
  "mcpServers": {
    "seco-labor": {
      "command": "uvx",
      "args": ["seco-labor-mcp"]
    }
  }
}

Cloud / SSE

pip install seco-labor-mcp
MCP_TRANSPORT=sse PORT=8000 seco-labor-mcp

The SSE server binds to 127.0.0.1 (loopback) by default to prevent NeighborJack on shared networks. For container deployments where you actually need to accept traffic from outside the container, set HOST=0.0.0.0 explicitly โ€” ideally in your Dockerfile / orchestrator config, and only behind an upstream proxy or firewall:

HOST=0.0.0.0 MCP_TRANSPORT=sse PORT=8000 seco-labor-mcp   # container only

Development

git clone https://github.com/malkreide/seco-labor-mcp.git
cd seco-labor-mcp
pip install -e ".[dev]"
pytest tests/ -m "not live" -v

Usage Examples

Search for youth unemployment data

Tool: seco_search_datasets
Input: { "query": "Jugendarbeitslosigkeit Alter", "limit": 5 }

Get cantonal unemployment for Zรผrich

Tool: seco_get_unemployment_overview
Input: { "canton": "ZH", "response_format": "markdown" }

Get monthly report URL

Tool: seco_get_monthly_report_url
Input: { "year": 2026, "month": 2, "language": "de" }

Key Concepts

Arbeitslose vs. Stellensuchende

Eselsbrรผcke: Arbeitslose โŠ‚ Stellensuchende โ€” Arbeitslose sind eine Teilmenge.

Term Definition Dec 2025
Arbeitslose RAV-registered, immediately available ~149'000 (3.2%)
Stellensuchende All RAV-registered (incl. training programs) ~233'900

Youth Unemployment Seasonality

  • July/August: Sharp increase (school leavers without placements)
  • September/October: Decline (apprenticeship starts)
  • The residual that remains after the autumn decline signals structural need for bridge programs (Brรผckenangebote)

Stellenmeldepflicht (since 2020)

Occupations with โ‰ฅ5% unemployment rate must be reported to the RAV before posting publicly. The list changes annually. This is directly relevant for vocational counseling โ€” these professions have highest availability for Swiss job seekers.


Portfolio Synergies

Server Synergy
swiss-statistics-mcp BFS population/employment data for deeper context
zurich-opendata-mcp City of Zurich-level education and social data
swiss-snb-mcp Economic context (GDP, wages) for labor market interpretation
fedlex-mcp ALV (Arbeitslosenversicherung) legislative framework

Known Limitations

  • amstat.arbeit.swiss has no public REST API (JavaScript SPA) โ†’ workaround via CKAN
  • Occupational/sectoral detail requires CSV download from SECO resources
  • Monthly press report URL patterns may vary for older reports
  • Cantonal sub-municipal data not available at this level

Phase 2 roadmap:

  • Automatic CSV caching with 24h TTL
  • Direct XLSX parsing for cantonal breakdowns
  • Integration with zh-education-mcp for Schulamt-specific correlations

Data License

SECO data published on opendata.swiss is under Creative Commons CCZero (public domain).
Source: Staatssekretariat fรผr Wirtschaft (SECO) โ€” seco.admin.ch


๐Ÿ›ก๏ธ Safety & Limits

Aspect Details
Access Read-only (readOnlyHint: true) โ€” the server cannot modify or delete any data
Personal data No personal data โ€” all sources are aggregated, anonymous public statistics
Rate limits No enforced external limits; server caps queries at 20 results by default; 30 s HTTP timeout
Authentication No API keys required โ€” opendata.swiss and arbeit.swiss are publicly accessible
Licenses SECO data under Creative Commons CCZero (public domain)
Terms of Service Subject to ToS of: opendata.swiss, SECO, arbeit.swiss
GDPR / DSG Fully compliant โ€” no personal data transmitted or stored; all data is official public statistics

Contributing

See CONTRIBUTING.md for development guidelines.


Security

See SECURITY.md for the security posture and how to report a vulnerability.


License

Released under the MIT License โ€” Copyright ยฉ 2026 Hayal Oezkan.


Author

Hayal Oezkan ยท github.com/malkreide

Installation

Run via uv's uvx โ€” no clone or manual install needed. Add to your MCP client config (mcpServers for Claude Desktop, Cursor and Windsurf; use a top-level servers key for VS Code in .vscode/mcp.json):

{
  "mcpServers": {
    "seco-labor-mcp": {
      "command": "uvx",
      "args": [
        "seco-labor-mcp"
      ]
    }
  }
}

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

seco_labor_mcp-0.3.4.tar.gz (89.0 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

seco_labor_mcp-0.3.4-py3-none-any.whl (23.9 kB view details)

Uploaded Python 3

File details

Details for the file seco_labor_mcp-0.3.4.tar.gz.

File metadata

  • Download URL: seco_labor_mcp-0.3.4.tar.gz
  • Upload date:
  • Size: 89.0 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for seco_labor_mcp-0.3.4.tar.gz
Algorithm Hash digest
SHA256 d25ee51d573de81671b18810298350290257ba284d8526b4095ce623bd306195
MD5 e3f25b1d5fb59d8354627d7119caab2f
BLAKE2b-256 7ec49aa0d2ecf08f55f93b974482a304a0b3465b61288187660c4c275beda551

See more details on using hashes here.

Provenance

The following attestation bundles were made for seco_labor_mcp-0.3.4.tar.gz:

Publisher: publish.yml on malkreide/seco-labor-mcp

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file seco_labor_mcp-0.3.4-py3-none-any.whl.

File metadata

  • Download URL: seco_labor_mcp-0.3.4-py3-none-any.whl
  • Upload date:
  • Size: 23.9 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for seco_labor_mcp-0.3.4-py3-none-any.whl
Algorithm Hash digest
SHA256 81fabe849e3f207823de9261f1ce5bea6c2d4b5dbabb6654ddb5a2947dd1c2ec
MD5 c31a191b59d1a4deb5d207b06eba0f11
BLAKE2b-256 6884338bb460644afe49fecba532cb396c51e4ae46521f31515a7d02e7640786

See more details on using hashes here.

Provenance

The following attestation bundles were made for seco_labor_mcp-0.3.4-py3-none-any.whl:

Publisher: publish.yml on malkreide/seco-labor-mcp

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page