by cammac-creator · HTML
Swiss customs (TARES), FINMA registry & NOGA/NACE/ISIC classifications. 9 MCP tools, free tier.
Access Swiss customs TARES, FINMA registry, and business classifications with 9 MCP tools.
Captured live from the server via tools/list.
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.
8-digit Swiss tariff number
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.
Entity name (or substring)
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.
Source classification code (e.g. '01', '6201', '47.91')
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.
Free-text French description of a good
Embedding language (FR-only in v1)
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.
Free-text business description (FR)
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.
Entity name (or partial / mistyped name)
Also search 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.
8-digit Swiss tariff number
ISO date (YYYY-MM-DD); only changes recorded on/after are returned
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 UID (e.g. CHE-103.137.179)
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.
NOGA 2-digit division code (e.g. '62' = Programmation, conseil et autres activités informatiques). Returns all cantons if no canton_code is given.
Optional canton code 1-26 (FSO numbering: 1=ZH, 2=BE, ..., 26=JU). Use '999' for Switzerland-wide totals.
Normalized Swiss government datasets for data engineers and compliance officers.
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
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 suiteOPENSWISSDATA_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.
claude_desktop_config.json
{
"mcpServers": {
"openswissdata": {
"command": "npx",
"args": [
"-y",
"@openswissdata/mcp@0.1.1"
],
"env": {
"OPENSWISSDATA_API_KEY": "<YOUR_OPENSWISSDATA_API_KEY>",
"OPENSWISSDATA_BASE_URL": "https://mcp.openswissdata.com",
"OPENSWISSDATA_TIMEOUT_MS": "30000"
}
}
}
}