# openswissdata MCP server

Swiss federal open data via MCP: TARES tariffs, FINMA registry, NOGA codes (tools).

## Links
- Registry page: https://www.getdrio.com/mcp/io-github-cammac-creator-openswissdata
- Repository: https://github.com/cammac-creator/openswissdata
- Website: https://www.openswissdata.com

## Install
- Command: `npx -y @openswissdata/mcp`
- Endpoint: https://mcp.openswissdata.com/jsonrpc
- Auth: Not captured

## Setup notes
- Package: Npm @openswissdata/mcp v0.1.1
- Environment variable: OPENSWISSDATA_API_KEY (secret)
- Environment variable: OPENSWISSDATA_BASE_URL (default https://mcp.openswissdata.com)
- Environment variable: OPENSWISSDATA_TIMEOUT_MS (default 30000)
- Remote endpoint: https://mcp.openswissdata.com/jsonrpc

## Tools
- tariff_lookup - Lookup a Swiss customs tariff (HS8) and return the full TARES row including MFN duty, preferential regimes, restrictions and customs relief codes. Always returns a non-official disclaimer that the agent must surface to the end user. Endpoint: https://mcp.openswissdata.com/jsonrpc
- kyc_check - Search the FINMA registry of supervised entities and the FINMA warnings list by name. Returns up to top_k authorised entities + any matching warning entries. Use this for basic counterparty KYC screening. Endpoint: https://mcp.openswissdata.com/jsonrpc
- cross_walk - Translate an industry classification code between schemes (NOGA 2008/2025, NACE 2.0/2.1, ISIC 4). Returns all mappings with their type (exact, partial, aggregated, derived) and notes. Endpoint: https://mcp.openswissdata.com/jsonrpc
- tariff_semantic_search - Semantic search across Swiss customs tariff (TARES) descriptions in French. Uses pre-computed Xenova/paraphrase-multilingual-mpnet-base-v2 embeddings (768d, FR) shipped with the TARES Pro bundle. Returns top-K HS8 codes by cosine similarity. Always inlines a non-official disclaimer. Endpoint: https://mcp.openswissdata.com/jsonrpc
- classify_text - Classify a free-text business description into top-K NOGA 2025 codes with confidence scores. Uses pre-computed Xenova/paraphrase-multilingual-mpnet-base-v2 embeddings (768d, FR). NACE 2.1 mode falls back to NOGA 2025 in v1 — combine with cross_walk for translation. Endpoint: https://mcp.openswissdata.com/jsonrpc
- finma_search - Fuzzy search the FINMA registry by name (tolerates typos and legal-suffix variants like 'UBS Switzerland AG' vs 'UBS AG'). Returns top-K matches with confidence score, including LEI/UID where available. Set include_warnings=true to also surface entries from the FINMA warnings list. Endpoint: https://mcp.openswissdata.com/jsonrpc
- tariff_changelog - Returns the historical changelog of MFN duty rates (and adjacent fields) for a Swiss customs tariff (HS8) code. Window: rolling 12-24 months. Irreplicable by scraping — xtares.admin.ch only serves the current version. Requires `hs8`; optional `since` (ISO date) to bound the window. Endpoint: https://mcp.openswissdata.com/jsonrpc
- entity_history - Returns the timeline of changes for a FINMA-supervised entity (registration, authorisation type changes, status mutations, address moves, warning-list flag transitions). Keyed by Swiss UID (CHE-xxx.xxx.xxx). Irreplicable by scraping — finma.ch only publishes the current state. Endpoint: https://mcp.openswissdata.com/jsonrpc
- statent_lookup - Swiss enterprise statistics (STATENT, BFS) for a NOGA 2-digit division and optional canton. Returns count of establishments, jobs, and full-time equivalents (FTE). 2023 data. Always inlines a BFS attribution disclaimer. Endpoint: https://mcp.openswissdata.com/jsonrpc

## Resources
Not captured

## Prompts
Not captured

## Metadata
- Owner: io.github.cammac-creator
- Version: 0.1.1
- Runtime: Npm
- Transports: STDIO, HTTP
- License: Not captured
- Language: Not captured
- Stars: Not captured
- Updated: May 6, 2026
- Source: https://registry.modelcontextprotocol.io