Openswissdata

@cammac-creator

About Openswissdata

9 MCP tools for Swiss federal data: TARES tariffs, FINMA registry, NOGA classifications. BAZG-authorized.

#swiss #federal #tares #finma #noga #customs #compliance #kyc #government #mcp

Config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "openswissdata": {
      "command": "npx",
      "args": [
        "-y",
        "@openswissdata/mcp"
      ]
    }
  }
}

Tools

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.

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.

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.

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.

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.

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.

Returns the historical changelog of MFN duty rates (and adjacent fields) for a Swiss customs tariff (HS8) code, across every dated release we have archived (history deepens over time from launch). Irreplicable by scraping — xtares.admin.ch only serves the current version. Requires `hs8`; optional `since` (ISO date) to bound the window.

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.

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.

Overview

What is Openswissdata?

Openswissdata is an MCP server that provides 9 dedicated tools to look up Swiss federal open data from any MCP client (Claude Desktop, Cursor, Cline, Claude Code). It covers the TARES customs tariff schedule, the FINMA authorized financial entities registry, and NOGA/NACE/ISIC economic activity classifications.

How to use Openswissdata?

Run npx -y @openswissdata/mcp to start the server. For Claude Desktop, add the server configuration to claude_desktop_config.json with the command npx and args ["-y", "@openswissdata/mcp"]. The anonymous tier works out of the box with approximately 100 requests per day per IP; for higher quotas you can bring your own API key from https://www.openswissdata.com.

Key features of Openswissdata?

9 dedicated tools for Swiss federal open data
Covers customs tariffs (TARES), financial entities (FINMA), and economic classifications
Natural language semantic search across tariffs
Cross‑walk mapping between NOGA, NACE, and ISIC codes
Business description classification to NOGA codes
Combined KYC entity verification (FINMA + tariff)
Data provenance with Ed25519 signatures and RFC-3161 timestamps

Use cases of Openswissdata?

Lookup HS codes by description or code for customs purposes
Search financial entities supervised by FINMA with audit trail
Classify business descriptions to NOGA economic activity codes
Map codes between different classification systems (NOGA, NACE, ISIC)
Perform combined entity verification for KYC processes

FAQ from Openswissdata

What datasets does Openswissdata cover?

It covers the TARES Swiss customs tariff schedule (BAZG), the FINMA authorized financial entities registry, and NOGA/NACE/ISIC economic activity classifications.

Is there a free tier?

Yes, the anonymous tier works out of the box with approximately 100 requests per day per IP.

How do I get a higher request quota?

Bring your own OPENSWISSDATA_API_KEY from https://www.openswissdata.com for higher quotas.

What is the provenance of the data?

All dataset releases are signed with Ed25519 signatures and RFC-3161 timestamps. Written commercial permission from BAZG (Federal Customs) was obtained. The source code is public on GitHub under Apache 2.0 license.

What tools are available?

Nine tools: tariff_lookup, tariff_semantic_search, tariff_changelog, cross_walk, classify_text, kyc_check, `fin

Frequently asked questions

What datasets does Openswissdata cover?

It covers the TARES Swiss customs tariff schedule (BAZG), the FINMA authorized financial entities registry, and NOGA/NACE/ISIC economic activity classifications.