Skip to main content
Glama

Server Details

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

If you are the author of this connector, you can claim ownership by verifying the domain or GitHub account it belongs to. Claimed connector authors can inspect health checks, view analytics, and manage their listing.
Status
Healthy
Uptime
99.9% over 62 days
Last Tested
Transport
Streamable HTTP · MCP 2025-11-25
URL
Repository
cammac-creator/openswissdata
GitHub Stars
0

TDQS

A3.9/5.0

Scored across 7 tools

Disambiguation3/5

finma_search and kyc_check both search the FINMA register and warnings list by name, with only subtle differences (match_type labels and include_warnings vs top_k), so an agent could easily pick the wrong one. tariff_lookup and tariff_semantic_search also overlap since semantic_search accepts a tariff number as well as a description. The remaining tools (classify_text, company_check, cross_walk) are clearly distinct, but these two overlapping pairs pull the score down.

Naming Consistency4/5

All names use snake_case and are descriptive, but they mix verb_noun (classify_text, finma_search, tariff_lookup, tariff_semantic_search) and noun_verb (company_check, kyc_check) patterns. cross_walk is idiomatic rather than following either convention. The set is readable and predictable in style, just not a single uniform pattern.

Tool Count4/5

Seven tools is a well-scoped size for a Swiss open-data server spanning classifications, company registry, FINMA and tariffs. Each tool maps to a real function, though the finma_search/kyc_check pair suggests one tool could be redundant. Nothing feels padded or missing on count alone.

Completeness4/5

The surface covers the four apparent domains: activity classification (classify_text, cross_walk), company registry (company_check), financial supervision (finma_search, kyc_check) and customs tariffs (tariff_lookup, tariff_semantic_search). company_check explicitly omits FOSC publications, SECO sanctions and officers, which are acknowledged gaps but not necessarily core to the stated scope. Coverage is solid for the advertised lookups.

Available Tools

7 tools
classify_textNOGA 2025 classification of a business description (free trial, 20 calls per day)A
Read-onlyIdempotent
Inspect

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.

ParametersJSON Schema
NameRequiredDescriptionDefault
langNoLanguage of the returned labels; the search itself covers all four languagesfr
textYesBusiness activity description in French, German, Italian or English, or a NOGA 2025 code (e.g. 62.10)
top_kNo
schemeNoNOGA_2025

TDQS

A4.4/5.0
Behavior5/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

Annotations already cover the safety profile (readOnly, idempotent, non-destructive), and the description adds substantial non-annotation behavior: a 20-calls/day/IP quota shared across three tools, per-answer reporting of remaining trial calls, a pinned multilingual mpnet model, index provenance and reference-version disclosure, plus a correctness caveat to verify against official FSO publications.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness4/5

Is the description appropriately sized, front-loaded, and free of redundancy?

Two dense blocks: trial/quota terms first, then the classification semantics and output. Every sentence carries information, though the free-trial framing echoes the title and pushes the core purpose slightly past the opening. Still efficient and reasonably front-loaded.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness5/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

With no output schema, the description carries the return-value burden and does so thoroughly: subclasses, NACE class, official hierarchy, similarity score, index provenance and reference version. It also signals the complementary cross_walk call, leaving nothing essential for an agent to infer.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema coverage is only 50%: lang and text are documented, but top_k and scheme carry no schema descriptions. The description compensates partially by explaining the four supported languages and that a NOGA code passed as text lists its subclasses, but it never clarifies top_k behavior or the NOGA_2025 vs NACE_2.1 scheme choice, leaving a real gap.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

States a specific verb ("Classify") and resource ("a business activity description") and names the exact output artifact: NOGA 2025 subclasses (6 digits) plus NACE 2.1 class, hierarchy and similarity score. It also distinguishes itself from the sibling cross_walk by routing cross-standard lookups there.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines4/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

Gives clear context: it names the free-trial quota shared with tariff_semantic_search and finma_search, notes the multilingual input scope, and directs the user to combine with cross_walk for NACE/ISIC/NOGA 2008. It stops short of an explicit when-to-use-this-instead-of tariff_semantic_search statement, so it is strong but not exhaustive.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

company_checkSwiss company check by UIDA
Read-onlyIdempotent
Inspect

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.

ParametersJSON Schema
NameRequiredDescriptionDefault
uidYesSwiss UID (CHE-xxx.xxx.xxx)

TDQS

A4.4/5.0
Behavior5/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

Annotations already cover read-only, idempotent, open-world and non-destructive traits, and the description still adds substantial behavior: per-fact source attribution with read dates, cross-checks between sources, swisstopo address validation only 'when published', and Zefix-derived register status with deletion dates. This is exactly the provenance/availability nuance annotations cannot express.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness4/5

Is the description appropriately sized, front-loaded, and free of redundancy?

Front-loaded with the verb and resource, then layered with data sources, coverage caveats and exclusions. Dense but every clause carries information; the parenthetical source names and 'when available' qualifiers are necessary rather than filler.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness5/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

No output schema exists, so the description must convey what comes back — and it does: sourced facts, read dates, cross-checks, address validation and register status, plus an explicit list of what is not covered. An agent knows the response shape and limits before calling.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Only one parameter and schema coverage is 100%, so the schema already documents uid fully. The description repeats the CHE-xxx.xxx.xxx format rather than adding syntax or validation detail beyond the schema, so the baseline 3 applies.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

States a specific verb and resource ('Look up a Swiss company by its UID') and enumerates the exact data domains returned (LINDAS commercial register, FINMA, GLEIF LEI, Zefix status), which differentiates it from siblings like finma_search or kyc_check without opening either schema.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines4/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

Gives clear scope boundaries and exclusions ('FOSC publications, SECO sanctions and officers are not covered'; 'No score'), which implicitly routes scoring-style needs to kyc_check. It stops short of explicitly naming the alternative tool or stating when this should be preferred over kyc_check.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

cross_walkNOGA / NACE / ISIC code correspondenceA
Read-onlyIdempotent
Inspect

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.

ParametersJSON Schema
NameRequiredDescriptionDefault
codeYesSource code, with or without dot (01, 6201, 47.91).
sourceYes
targetYes

TDQS

A4/5.0
Behavior4/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

Annotations already cover the safety profile (readOnly, idempotent, non-destructive, closed-world). The description goes beyond them by disclosing output semantics (exact vs approximate relation, sources, documented path) and a meaningful behavioral rule about not chaining non-exact relations and requiring expert validation for approximate matches.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

Two tightly written sentences with the scope front-loaded and a critical caveat second. No filler, no restatement of the title, and every clause carries information an agent needs.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness4/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

With no output schema, the description does the work of describing the return contents (relation type, sources, documented path) and its reliability caveat. It is nearly complete for a 3-parameter lookup tool; only the directionality and self-mapping rules for source/target are left unspecified.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema coverage is only 33%: the 'code' parameter is documented with format examples in the schema, and the two enum parameters are self-describing. The description adds value by enumerating the classification families and their geographic origin (Swiss/EU/UN), but says nothing about directionality of the mapping, whether source and target may coincide, or how ambiguity is resolved.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description states a specific verb ('Find correspondences') and names the exact resources involved (NOGA 2008, NOGA 2025, NACE 2.0, NACE 2.1, ISIC 4), plus clarifying them as Swiss, EU and UN classifications. An agent immediately understands this is a cross-classification code mapping tool and can distinguish it from kyc_check and tariff_lookup.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines3/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

It provides an important operating constraint ('Never chains two non-exact relations; a non-exact correspondence needs expert validation'), which guides how to interpret and act on results. However, it never states when to reach for this tool versus the sibling tools, nor any prerequisites such as whether source and target may be identical.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

kyc_checkFINMA register and warnings list checkA
Read-onlyIdempotent
Inspect

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.

ParametersJSON Schema
NameRequiredDescriptionDefault
nameYesEntity name (or a distinctive part of it)
top_kNo

TDQS

A4/5.0
Behavior5/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

Goes well beyond the annotations (which only declare read-only/idempotent/safe). It discloses the ranking algorithm (exact name, whole word, substring, all-words fallback), that the total match count is returned, that only an identical name counts as a warning-list match while similar names are reported separately for verification, and the important caveat that a negative result is not a compliance certificate.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness4/5

Is the description appropriately sized, front-loaded, and free of redundancy?

Purpose is front-loaded in the first clause and each subsequent sentence carries distinct information (matching order, match semantics, caveat). Sentences are long with stacked parentheticals, which slightly hurts scannability, but there is no filler.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness4/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

With no output schema, the description carries the return burden and does so adequately: it names the returned items (closest authorised entities and warning entries) and the total match count. Only minor gaps remain (no note on rate limits or result-size behavior) for what is otherwise a complete two-parameter read tool.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters4/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema coverage is only 50% (top_k is undocumented in the schema), so the description must compensate. It explains top_k semantically ('returns the closest top_k ... entries') and adds case- and accent-insensitive matching for name, which the schema does not state. Bounds and defaults are left to the schema, which is acceptable.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose4/5

Does the description clearly state what the tool does and how it differs from similar tools?

States a specific verb (search) and two named resources (FINMA register of supervised institutions, FINMA warnings list) with the matching key (name). An agent can tell what it does, but the sibling tool 'finma_search' is not differentiated, leaving ambiguity about which FINMA search to pick.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines3/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

Gives a usage context ('Use it for basic counterparty screening') and a caution ('no result is not a compliance certificate'), which is useful framing. However it never states when to prefer this over the closely related 'finma_search' or any exclusions, so routing between siblings is left to inference.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

tariff_lookupSwiss customs tariff line (TARES)A
Read-onlyIdempotent
Inspect

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.

ParametersJSON Schema
NameRequiredDescriptionDefault
hs8YesSwiss tariff number: 8 digits for one line (dots allowed, e.g. 8471.3000), or a 2- to 7-digit HS prefix (e.g. the international HS6 code 847130) to list the Swiss 8-digit lines under it
langNofr

TDQS

A4.2/5.0
Behavior4/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

Annotations already cover readOnly, idempotent, non-destructive and closed-world semantics, so the bar is lower. The description adds genuinely new behavioral context: every result carries an unofficial-copy notice the agent must show the end user, plus a breakdown of what the line contains (designations, MFN duty, preferential regimes, restrictions, relief codes).

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

Three tight sentences, front-loaded with the verb and resource, then the two input modes, then the notice obligation. No filler or redundancy.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness4/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

With no output schema, the description does the work of describing the return payload (designations, duties, preferential regimes, restrictions, relief codes) and adds the mandatory unofficial-copy notice. The only real gap is the behavior of the lang parameter, which is left implicit.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema coverage is 50%: hs8 is fully documented in the schema and the description largely restates it (dots allowed, prefix behavior). The lang enum has no schema description, and the description only hints at it via 'designations in FR/DE/IT/EN' without stating that lang controls the output language. Baseline 3 is appropriate given partial coverage.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

States a specific verb (look up) and resource (Swiss customs tariff / TARES), and clearly distinguishes itself from siblings cross_walk and kyc_check, which are unrelated domains. An agent can identify the operation and scope without opening the schema.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines4/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The description explicitly explains the two usage modes — an 8-digit number returns one full line, a 2- to 7-digit HS prefix lists the Swiss lines under it — which tells the agent how to invoke it correctly. It does not name alternatives or exclusions, but the sibling tools are in different domains so that is less critical.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

  1. 1 tool update
    • Addedcompany_check
  2. 3 tool updates
    • Addedclassify_text
    • Addedfinma_search
    • Addedtariff_semantic_search
  3. 8 tool updates
    • Removedclassify_text
    • Changedcross_walk1 field changed
      • changedInput schema / properties / code / description
        Previous value: -"Code source, avec ou sans point (01, 6201, 47.91)."New value: +"Source code, with or without dot (01, 6201, 47.91)."
    • Removedentity_history
    • Removedfinma_search
    • Changedkyc_check2 fields changed
      • changedInput schema / properties / name / description
        Previous value: -"Entity name (or substring)"New value: +"Entity name (or a distinctive part of it)"
      • addedInput schema / properties / name / maxLength
        Added value: +200
    • Removedtariff_changelog
    • Changedtariff_lookup2 fields changed
      • changedInput schema / properties / hs8 / description
        Previous value: -"8-digit Swiss tariff number"New value: +"Swiss tariff number: 8 digits for one line (dots allowed, e.g. 8471.3000), or a 2- to 7-digit HS prefix (e.g. the international HS6 code 847130) to list the Swiss 8-digit lines under it"
      • changedInput schema / properties / hs8 / pattern
        Previous value: -"^\\d{8}$"New value: +"^[0-9][0-9. ]{1,11}$"
    • Removedtariff_semantic_search
  4. 1 tool update
    • Removedstatent_lookup
  5. 1 tool update
    • Changedcross_walk1 field changed
      • changedInput schema / properties / code / description
        Previous value: -"Source classification code (e.g. '01', '6201', '47.91')"New value: +"Code source, avec ou sans point (01, 6201, 47.91)."
  6. 9 tool updates
    • First observedclassify_text
    • First observedcross_walk
    • First observedentity_history
    • First observedfinma_search
    • First observedkyc_check
    • First observedstatent_lookup
    • First observedtariff_changelog
    • First observedtariff_lookup
    • First observedtariff_semantic_search

Related MCP Connectors

Related MCP Servers

  • A
    license
    A
    quality
    B
    maintenance
    An MCP server for Swiss company data. Nine tools that look a company up by UID, search 790,000 of them by name or by statutory purpose, trace what changed in the commercial register, browse public tenders, check a bank licence, resolve a UID to an LEI and its group parent, and find federally funded research a company took part in. Built by https://prospex.ch
    9
    MIT
  • F
    license
    Not graded
    quality
    C
    maintenance
    The most comprehensive signal intelligence on Swiss businesses — 800K+ companies with people, FINMA/SRO regulatory data, building permits, procurement tenders, and AI-enriched profiles from the official commercial register.
    -
  • A
    license
    A
    quality
    C
    maintenance
    Search and retrieve detailed information about Swiss companies from the official Zefix register, including company profiles, corporate structures, and SHAB publications.
    6
    MIT
  • A
    license
    A
    quality
    B
    maintenance
    Enables searching the Swiss commercial register, retrieving company and SOGC publication data, and validating Swiss UID and VAT numbers via the Zefix REST API and UID Webservice, including combined due-diligence reports.
    9
    MIT
Try in Browser

Glama MCP Gateway

Add one secure layer between your agents and this server.