Summary
Pulls normalized Swiss federal datasets into Claude: TARES customs tariff codes, FINMA's financial institution registry, and NOGA economic activity classifications. You get nine tools that query production APIs hosted at mcp.openswissdata.com. Reach for this when you're building compliance workflows, need to validate Swiss business registrations, or are working with import/export documentation that references official tariff nomenclature. The maintainer runs ETL pipelines to keep each dataset synced with government sources and versions the releases. Built for data engineers who'd rather query clean APIs than scrape PDF tables from admin.ch.
Install to Claude Code
verifiedclaude mcp add --transport http openswissdata https://mcp.openswissdata.com/jsonrpcRun in your terminal. Add --scope user to make it available in every project.
Review the command, arguments, and environment values before installing — MCP servers run with your local permissions.
Plug Mailtrap into your AI workflow and let it handle the email.
Connect Mailtrap MCP →
Agent, run crypto. Access onchain data & trade routes via 1inch.
Install now →
Make coding agent sessions - Searchable, Shareable, Vendor-neutral & Scored.
Try For Free →
Your agent targets a perfect 10 Code Health score. Deterministic. Every commit.
Try For Free →
Integrate web data into your AI product. One API to scrape website & brand data.
Get API Key Now →
belt cli automatically finds the best tools and skills for your agent. image, video, music, tts...
one prompt install →Tools
Verified live against the running server on Jun 10, 2026.
verified live9 tools
tariff_lookupLookup 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.2 params
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.
Parameters* required
hs8*string8-digit Swiss tariff number
langstringone of
fr · de · it · endefault: frkyc_checkSearch 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.2 params
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.
Parameters* required
name*stringEntity name (or substring)
top_kintegerdefault: 10
cross_walkTranslate 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.3 params
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.
Parameters* required
code*stringSource classification code (e.g. '01', '6201', '47.91')
source*stringone of
NOGA_2008 · NOGA_2025 · NACE_2.0 · NACE_2.1 · ISIC_4target*stringone of
NOGA_2008 · NOGA_2025 · NACE_2.0 · NACE_2.1 · ISIC_4tariff_semantic_searchSemantic 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 discl...3 params
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 discl...
Parameters* required
langstringEmbedding language (FR-only in v1)one of
frdefault: frquery*stringFree-text French description of a good
top_kintegerdefault: 5
classify_textClassify 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.4 params
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.
Parameters* required
langstringone of
frdefault: frschemestringone of
NOGA_2025 · NACE_2.1default: NOGA_2025text*stringFree-text business description (FR)
top_kintegerdefault: 3
finma_searchFuzzy 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...3 params
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...
Parameters* required
include_warningsbooleanAlso search the FINMA warnings listdefault: false
name*stringEntity name (or partial / mistyped name)
top_kintegerdefault: 5
tariff_changelogReturns 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 wi...2 params
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 wi...
Parameters* required
hs8*string8-digit Swiss tariff number
sincestringISO date (YYYY-MM-DD); only changes recorded on/after are returned
entity_historyReturns 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.1 params
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.
Parameters* required
uid*stringSwiss UID (e.g. CHE-103.137.179)
statent_lookupSwiss 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.2 params
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.
Parameters* required
canton_codestringOptional canton code 1-26 (FSO numbering: 1=ZH, 2=BE, ..., 26=JU). Use '999' for Switzerland-wide totals.
noga_division*stringNOGA 2-digit division code (e.g. '62' = Programmation, conseil et autres activités informatiques). Returns all cantons if no canton_code is given.
openswissdata.com
Normalized Swiss government datasets for data engineers and compliance officers.
Local dev
npm install
cp .env.example .env
# fill in secrets
npm run db:migrate && npm run db:seed
npm run dev
API on http://localhost:3000
Scripts
npm run dev— hot-reload backendnpm run web:dev— Astro frontendnpm run etl:tares|classifications|finma— refresh dataset and release new versionnpm run test— run test suite
Featured
Plug Mailtrap into your AI workflow and let it handle the email.
Connect Mailtrap MCP →Agent, run crypto. Access onchain data & trade routes via 1inch.
Install now →Make coding agent sessions - Searchable, Shareable, Vendor-neutral & Scored.
Try For Free →Your agent targets a perfect 10 Code Health score. Deterministic. Every commit.
Try For Free →Integrate web data into your AI product. One API to scrape website & brand data.
Get API Key Now →belt cli automatically finds the best tools and skills for your agent. image, video, music, tts...
one prompt install →Configuration
OPENSWISSDATA_API_KEYsecretOptional Bearer token for higher quotas / Pro tools. Anonymous tier works without it (~100 req/day/IP).
OPENSWISSDATA_BASE_URLdefault: https://mcp.openswissdata.comOverride the remote MCP endpoint (default: https://mcp.openswissdata.com). Useful for staging or self-hosting.
OPENSWISSDATA_TIMEOUT_MSdefault: 30000Per-request timeout in milliseconds.
Categories
Registryactive
Package@openswissdata/mcp
TransportSTDIO, HTTP
AuthRequired
Tools verifiedJun 10, 2026
UpdatedMay 6, 2026
