OpenSwissData

io.github.cammac-creatorPublished by GitHub account cammac-creatorv0.3.2Updated Nov 5, 2026

Swiss customs tariff (TARES), FINMA register, NOGA/NACE/ISIC codes. 4 free tools + search trial.

VerifiedStreamable HTTPWeb executableFinanceData & AnalyticsBusiness & Commerce

Overview

AI-generated overview

MCP server for Swiss federal reference data: customs tariff (TARES) lines, FINMA register and warnings, and NOGA/NACE/ISIC code mapping.

What you can do
  • Look up Swiss customs tariff lines by 8-digit number or HS prefix, with duty rates, preferences and restrictions
  • Search the FINMA register and warnings list by entity name, and check a Swiss company by UID across commercial register, FINMA and LEI records
  • Map activity codes between NOGA 2008/2025, NACE 2.0/2.1 and ISIC 4 with relation type and source
  • Find tariff lines from a goods description and classify business activities into NOGA codes (limited free trial)
When to use it
Useful when an assistant has to answer Swiss trade, customs or regulatory questions: duty rates for a product, whether an entity appears in the FINMA register or warnings, company identity checks by UID, or translating activity codes between Swiss, EU and UN classifications.
Requirements
Either the remote endpoint at mcp.openswissdata.com over HTTP, or the npm package @openswissdata/mcp run locally with Node 18+ (npx) as a stdio bridge. No key is needed for the four free tools; an optional OPENSWISSDATA_API_KEY carries existing OAuth rights. Optional OPENSWISSDATA_BASE_URL and OPENSWISSDATA_TIMEOUT_MS. Internet access required.
Before you install
Data is an unofficial copy, so results must be checked against official sources before any binding decision; an approximate code correspondence needs expert validation, a missing duty value does not mean duty-free, and no FINMA hit is not a compliance certificate. Keep notices shown with results. Rate limits apply per IP (100 calls/hour free, 20 calls/day for the three search tools). Keep OPENSWISSDATA_API_KEY in private client configuration; paid plans are closed and buying dataset files does…

Installation

In SourceWeft

  1. Open OpenSwissData in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.

Use with an agent

Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.

Read https://sourceweft.com/mcp/io.github.cammac-creator%2Fopenswissdata/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.

Read the install guide the agent follows

Other MCP clients

Add this to your client's mcpServers config.

{
  "mcpServers": {
    "openswissdata": {
      "type": "http",
      "url": "https://mcp.openswissdata.com/jsonrpc"
    }
  }
}

README

@openswissdata/mcp

MCP server for Swiss federal reference data: the Swiss customs tariff (TARES), the FINMA register of supervised institutions and the FINMA warnings list, and NOGA / NACE / ISIC activity-code correspondences. Four tools work without any key or sign-up.

This package is a small STDIO bridge to the remote OpenSwissData MCP endpoint, for clients that only launch local processes. Clients that speak MCP over HTTP can connect directly to https://mcp.openswissdata.com/jsonrpc without it.

Free tools (no key)

Limit: 100 calls per hour per IP address.

ToolWhat it answers
tariff_lookupAn 8-digit Swiss tariff number (dots allowed, e.g. 8471.3000) returns the full TARES line: designations in FR/DE/IT/EN, MFN duty, preferential regimes, restrictions, customs relief codes. A 2- to 7-digit HS prefix (e.g. the international HS6 code 847130) lists the Swiss 8-digit lines under it.
kyc_checkSearches the FINMA register and the FINMA warnings list by entity name.
company_checkA Swiss company by UID (CHE-xxx.xxx.xxx): commercial register, FINMA and LEI records, each fact with its source.
cross_walkMaps an activity code between NOGA 2008, NOGA 2025, NACE 2.0, NACE 2.1 and ISIC 4, with the relation type and its source.

tariff_semantic_search, classify_text and finma_search are free to try without a key: 20 calls per day in total per IP address. tariff_changelog and entity_history need existing access rights; new paid subscriptions are closed at the moment. Buying a dataset file does not create an API key. statent_lookup has been withdrawn.

Setup

Claude Code, remote endpoint (no bridge needed):

bash
claude mcp add --transport http openswissdata https://mcp.openswissdata.com/jsonrpc

Clients configured with mcpServers and a local process (Claude Desktop, Cline and others):

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

Tools and their schemas come from the server at each listing.

VariableDefaultUse
OPENSWISSDATA_API_KEYnoneExisting OAuth token, for the rights it carries
OPENSWISSDATA_BASE_URLhttps://mcp.openswissdata.comAlternative server
OPENSWISSDATA_TIMEOUT_MS30000Timeout, including reading the whole response

Keep a key in the client's private configuration. Diagnostics go to stderr; stdout is reserved for the protocol. openswissdata-mcp --version and --help print the version and help.

Development

Node 22 is used for the checks. The runtime keeps its Node 18+ declaration; use a maintained version.

bash
npm cinpm run typechecknpm testnpm run buildnpm pack --dry-run

The tests run a full MCP exchange with the official SDK and interrupt a response whose body stalls. A change in the repository does not publish a new npm version: check the registry separately before distribution.

The Dockerfile offers a local alternative: docker build -t openswissdata-mcp ., then docker run --rm -i openswissdata-mcp.

Limits

OpenSwissData is an unofficial copy. Keep the notices shown to the user. An approximate correspondence needs expert validation; a missing tariff value does not mean duty-free; no FINMA result is not a compliance certificate. Check the original sources (xtares.admin.ch, finma.ch, the Swiss Federal Statistical Office) before any decision.

Full datasets are sold as signed files at openswissdata.com. A summary for AI agents lives at openswissdata.com/llms.txt.

Apache-2.0 licence. Documentation of the MCP SDK used.

Source: sdks/mcp-server/README.md at commit cb7a25f

Tools

7

tariff_lookup

Swiss customs tariff line (TARES)

Look up the Swiss customs tariff (TARES). An 8-digit Swiss tariff number (dots allowed) returns the full line: designations in FR/DE/IT/EN, MFN duty, preferential regimes, restrictions and customs relief codes. A 2- to 7-digit HS prefix (for example the international HS6 code) lists the Swiss 8-digit lines under it. Every result carries an unofficial-copy notice that the agent must show to the end user.

Parametershs8requiredlang

kyc_check

FINMA register and warnings list check

Search the FINMA register of supervised institutions and the FINMA warnings list by name (case- and accent-insensitive). Returns the closest top_k authorised entities and warning entries (exact name, then whole word, then substring; all words in any order as a fallback) with the total number of matches. Only an identical name is reported as a FINMA warning-list match; a merely similar name is listed separately, to verify, and is never called a match. Use it for basic counterparty screening; no result is not a compliance certificate.

Parametersnamerequiredtop_k

company_check

Swiss company check by UID

Look up a Swiss company by its UID (CHE-xxx.xxx.xxx): commercial register data (LINDAS), FINMA register entries and LEI records (GLEIF), each fact with its source and, when known, the date it was read, plus exact cross-checks between sources and checks of the registered address against the official localities and streets directories (swisstopo, when published). No score. When available, the commercial register status (active, in liquidation or deleted, with the deletion date) is read from Zefix (OFRC). FOSC publications, SECO sanctions and officers are not covered.

Parametersuidrequired

cross_walk

NOGA / NACE / ISIC code correspondence

Find correspondences between NOGA 2008, NOGA 2025, NACE 2.0, NACE 2.1 and ISIC 4 activity codes (Swiss, EU and UN classifications). Returns the exact or approximate relation, its sources and the documented path. Never chains two non-exact relations; a non-exact correspondence needs expert validation.

Parameterscoderequiredsourcerequiredtargetrequired

classify_text

NOGA 2025 classification of a business description (free trial, 20 calls per day)

FREE TRIAL without a key: 20 calls per day per IP address in total for tariff_semantic_search, classify_text and finma_search. Each answer states the trial calls left; check every result on the NOGA publications of the Federal Statistical Office before use. Classify a business activity description (French, German, Italian or English) into the closest NOGA 2025 subclasses (6 digits) with their class (the NACE 2.1 class), official hierarchy and a similarity score, using a pinned multilingual mpnet model. A NOGA code as text lists its subclasses. Each answer states the index provenance and the classification reference version; combine with cross_walk for NACE, ISIC or NOGA 2008.

Parameterslangtextrequiredtop_kscheme

Version history

4
  1. v0.3.2LatestNov 5, 2026
  2. v0.3.1Sep 29, 2026
  3. v0.3.0Sep 29, 2026
  4. v0.2.1Sep 16, 2026

Score

90% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 daysRequired25 pts
  • Auth declaredRequired10 pts
  • Tools listedRequired15 pts
  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts

    Declare a license in the repository or the registry entry.