register-mcp 0.1.0

MCP Server for Swiss commercial register (Zefix/Handelsregister) and UID register

🇨🇭 Part of the Swiss Public Data MCP Portfolio

🏛️ register-mcp

MCP Server for the Swiss Federal Commercial Register (Zefix/Handelsregister) and supporting reference data

🇩🇪 Deutsche Version

---

Overview

register-mcp provides AI-native access to the Swiss Federal Commercial Register via the Zefix REST API, all without authentication:

Source	Data	API
Zefix (Handelsregister)	Swiss companies, legal forms, SHAB mutations	ZefixREST v1
SHAB	Official Gazette of Commerce — mutation publications	Embedded in Zefix

Designed for Swiss public administration use cases: vendor verification, contract partner due diligence, procurement screening, and supplier onboarding — all via natural language queries.

Anchor demo query: "We want to sign a framework agreement with Lehrmittelverlag Zürich AG. Is the company active in the commercial register, what is its stated corporate purpose, and have there been any SHAB mutations in the past two years?"

---

Features

• 🏛️ 6 tools for company search, verification, and reference data
• 🔍 zefix_verify_company — quick active/dissolved status check
• 🌐 Bilingual output (Markdown / JSON)
• 🔓 No API key required — open data from zefix.admin.ch
• ☁️ Dual transport — stdio (Claude Desktop) + SSE (cloud)

---

Prerequisites

• Python 3.11+
• uv (recommended) or pip

---

Installation

# Clone the repository
git clone https://github.com/malkreide/register-mcp.git
cd register-mcp

# Install
pip install -e .
# or with uv:
uv pip install -e .

Or with uvx (no permanent installation):

uvx register-mcp

---

Quickstart

# stdio (for Claude Desktop)
python -m register_mcp.server

# SSE (cloud deployment)
MCP_TRANSPORT=sse PORT=8000 python -m register_mcp.server

Try it immediately in Claude Desktop:

"Is Lehrmittelverlag Zürich AG active in the commercial register?" "Look up the company with UID CHE-108.954.978" "List all Swiss legal forms"

---

Configuration

Claude Desktop

Edit ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows):

{
  "mcpServers": {
    "register": {
      "command": "python",
      "args": ["-m", "register_mcp.server"]
    }
  }
}

Or with uvx:

{
  "mcpServers": {
    "register": {
      "command": "uvx",
      "args": ["register-mcp"]
    }
  }
}

Config file locations:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json

Cloud Deployment (SSE for browser access)

For use via claude.ai in the browser (e.g. on managed workstations without local software):

Render.com (recommended):

1. Push/fork the repository to GitHub
2. On render.com: New Web Service → connect GitHub repo
3. Set start command: python -m register_mcp.server --http --port 8000
4. In claude.ai under Settings → MCP Servers, add: https://your-app.onrender.com/sse

💡 "stdio for the developer laptop, SSE for the browser."

---

Available Tools

Tool	Description
zefix_search_companies	Search companies by name, canton, legal form
zefix_get_company	Full company profile by internal EHRAID
zefix_get_company_by_uid	Company lookup by UID (CHE-xxx.xxx.xxx)
zefix_verify_company	Quick active/dissolved status check
zefix_list_legal_forms	All Swiss legal forms with IDs
zefix_list_municipalities	Swiss municipalities with BFS IDs

Example Use Cases

Query	Tool
"Is Lehrmittelverlag Zürich AG active?"	zefix_verify_company
"Look up CHE-108.954.978"	zefix_get_company_by_uid
"Find companies named Migros in canton ZH"	zefix_search_companies
"List all Swiss legal forms"	zefix_list_legal_forms
"Show municipalities in canton Bern"	zefix_list_municipalities

---

Architecture

┌─────────────────┐     ┌──────────────────────────────┐     ┌──────────────────────────┐
│   Claude / AI   │────▶│       register-mcp            │────▶│  Zefix (Handelsregister)  │
│   (MCP Host)    │◀────│       (MCP Server)            │◀────│  ZefixREST/api/v1        │
└─────────────────┘     │                              │     └──────────────────────────┘
                        │  6 Tools                     │
                        │  Stdio | SSE                 │
                        │  No authentication required  │
                        └──────────────────────────────┘

Data Source Characteristics

Source	Protocol	Coverage	Auth
Zefix (Phase 1)	REST/JSON	Swiss companies, legal forms, SHAB	None
ZefixPublicREST (Phase 2)	REST/JSON	Signatories, capital, full history	Basic Auth (free)
UID Register (Phase 3)	SOAP	MwSt, NOGA codes, cross-validation	Public (20 req/min)

---

Phased Implementation

Phase	API	Auth	Status
Phase 1	ZefixREST/api/v1	None	Current
Phase 2	ZefixPublicREST/api/v1	Basic Auth (free, email [e-mail])	Planned
Phase 3	UID-Register SOAP	Public (20 req/min)	Planned

Phase 2 will add: signatory details, share capital, full historical entries. Phase 3 will add: MwSt status, NOGA industry codes, cross-register validation.

---

Project Structure

register-mcp/
├── src/register_mcp/
│   ├── __init__.py              # Package
│   └── server.py                # 6 tools (Zefix + reference data)
├── tests/
│   └── test_server.py           # Unit + integration tests (mocked HTTP)
├── .github/workflows/ci.yml     # GitHub Actions (Python 3.11/3.12/3.13)
├── pyproject.toml
├── CHANGELOG.md
├── CONTRIBUTING.md
├── LICENSE
├── README.md                    # This file (English)
└── README.de.md                 # German version

---

Known Limitations

• Search by canton without a name filter may return API errors (Zefix API limitation)
• SHAB publication message text contains XML-style markup (<FT TYPE="F">...)
• Phase 1 API may be rate-limited under heavy load; retry after a short delay
• ZefixPublicREST (new API) requires registration: email [e-mail]

---

Testing

# Unit tests (no API key required)
PYTHONPATH=src pytest tests/ -m "not live"

# Integration tests (live API calls)
pytest tests/ -m "live"

---

Changelog

See CHANGELOG.md

---

Contributing

See CONTRIBUTING.md

---

License

MIT License — see LICENSE

---

Author

Hayal Oezkan · malkreide

---

Credits & Related Projects

• Zefix: zefix.admin.ch — Swiss Federal Commercial Register (BJ/FOJ)
• SHAB: Swiss Official Gazette of Commerce — mutation publications
• Protocol: Model Context Protocol — Anthropic / Linux Foundation
• Related: fedlex-mcp — Commercial register ordinance (HRegV)
• Related: zurich-opendata-mcp — Company seat + geodata
• Related: swiss-statistics-mcp — Industry statistics by NOGA
• Related: swiss-snb-mcp — Economic indicators
• Portfolio: Swiss Public Data MCP Portfolio