Skip to main content
Glama
johnphilipp

mcp-server-zefix

by johnphilipp
OverviewSchemaSourceRelated ServersDiscussionsAdmin
Python
Hybrid

Server Configuration

Describes the environment variables required to run the server.

NameRequiredDescriptionDefault
ZEFIX_BASE_URLNoAPI base URLhttps://www.zefix.ch/ZefixREST/api/v1
ZEFIX_PASSWORDNoPassword for ZefixPublicREST API
ZEFIX_USERNAMENoUsername for ZefixPublicREST API

Instructions

Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.

This server publishes no instructions, or was last inspected before Glama recorded them.

Capabilities

Features and capabilities supported by this server

Protocol revision2025-11-25

CapabilityDetails
tools
{
  "listChanged": false
}
prompts
{
  "listChanged": false
}
resources
{
  "subscribe": false,
  "listChanged": false
}
experimental
{}

Tools

Functions exposed to the LLM to take actions

NameDescription
search_companiesA

Search Swiss companies in the Zefix register by name.

Use * as wildcard (e.g. "Novartis*" or "*pharma*"). Returns a list of
matching companies with UID, legal form, and registered office.

Args:
    name: Company name to search for. Supports * wildcard.
    canton: Two-letter canton code (e.g. ZH, BE, GE). Empty for all.
    active_only: If true, only return currently active companies.
    language: Response language (de, fr, it, en).
    max_results: Maximum number of results to return (1-500).
    offset: Pagination offset for retrieving additional results.
    legal_form_ids: Comma-separated legal form IDs (e.g. "3,4").
get_company_by_uidA

Get detailed information about a Swiss company by its UID number.

The UID (Unternehmens-Identifikationsnummer) is the unique identifier
for Swiss companies. Accepts various formats like CHE-123.456.789,
CHE123456789, or just 123456789.

Args:
    uid: Company UID in any format (e.g. CHE-123.456.789 or CHE123456789).
    language: Response language (de, fr, it, en).
get_company_by_chidA

Get detailed information about a Swiss company by its CH-ID.

The CH-ID is an alternative identifier used in the Swiss commercial
register system.

Args:
    chid: The CH-ID identifier (e.g. CH27030000714).
    language: Response language (de, fr, it, en).
list_legal_formsA

List all Swiss legal forms (Rechtsformen) recognized by Zefix.

Useful for understanding legal form IDs returned in search results,
or for filtering searches by legal form.

Args:
    language: Language for legal form names (de, fr, it, en).
get_company_publicationsA

Get SHAB publications (Swiss Official Gazette) for a company.

Returns a timeline of legally significant events: board changes,
capital changes, mergers, address changes, purpose changes, etc.

Args:
    uid: Company UID in any format (e.g. CHE-123.456.789 or CHE123456789).
    language: Response language (de, fr, it, en).
get_company_structureA

Get the corporate structure (head office and branches) of a Swiss company.

Shows the parent company (Hauptniederlassung) and all its branch offices
(Zweigniederlassungen) in a table with full addresses. Works whether you
pass the UID of the head office or any branch — the full structure is
returned either way.

Fetches detail for up to 50 branches. May take a while for large
structures since each branch requires a separate API call.

Args:
    uid: Company UID in any format (e.g. CHE-105.807.648 or CHE123456789).
    language: Response language (de, fr, it, en).

Prompts

Interactive templates invoked by user choice

NameDescription

No prompts

Resources

Contextual data attached and managed by the client

NameDescription

No resources

Deploy Server
One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

TDQS

A4.2/5.0

Scored across 6 tools

Disambiguation4/5

The tools are mostly distinct, but get_company_by_uid and get_company_by_chid both retrieve detailed company info and could be confused. However, the descriptions clearly differentiate them by identifier type, and search/list tools are unambiguous.

Naming Consistency5/5

All tool names follow a consistent verb_noun pattern (search, get, list) with snake_case throughout. The two get_company_by_* variants are uniformly structured.

Tool Count5/5

Six tools is an appropriate scope for a Swiss company register server, covering search, lookup, and ancillary data without redundancy or bloat.

Completeness4/5

The tool set covers the core functionality of the Zefix register: search, details by identifier, legal forms, publications, and corporate structure. Minor gaps exist (e.g., no direct address lookup or historical searches), but nothing critical for the apparent domain.

Maintenance

ActivityInactive
ResponsivenessNo issues

Resources