Global law
The law of nearly every country on earth, any date: read it, see what changed it, check citations.
IGE/IPI Swissreg trademarks, patents, SPCs
Las listas se ordenan por una puntuación de uso (sobre 100) con estas partes
| Popularidad | 0/80 | Estrellas de GitHub o descargas semanales: la mayor cuenta 60, la menor 20 |
|---|---|---|
| Actualidad | 12/12 | Puntuación completa con una versión o cambio de código en 30 días |
| Sigue respondiendo | 0/8 | El endpoint en la nube respondió en la última revisión |
| Puntuación de uso | 12/100 |
Calidad: Pasó 3/3 revisiones básicas (se muestra, no ordena) · Impulso: Sin datos aún (Solo se usa en la pestaña En auge)
Elige la app de IA que usas y copia la configuración.
Que tu IA lo instale con una frase
Instala Swiss Ip MCP. Sigue https://mcp.popnx.com/i/malkreide-swiss-ip-mcp.md, enséñame los comandos y espera mi OK antes de ejecutarlos.Pégala en una IA que trabaje en tu equipo (como Claude Code o Cursor). Lee nuestros pasos, te muestra los comandos y espera tu OK. Sin clave ni registro. · Ver el texto completo que lee tu IA
Pasó 3/3 revisiones · Funciona en tu computadora · ✓ Comandos revisados el 13 nov 2026
Primero: ¿qué IA usas?
Elige tu app y los pasos aparecen abajo.
Copia este mensaje en un chat de Claude. La IA revisa tu equipo, te dice qué archivo va a cambiar y espera tu visto bueno cada vez.
Instala el MCP server Swiss Ip MCP para Claude en este equipo, en este orden: 1) Comprueba uv con uv --version. Si falta, dime que lo instale desde https://docs.astral.sh/uv/getting-started/installation/; no lo instales tú. 2) Usa solo esta configuración (ya revisada por PopNx MCP): { "mcpServers": { "swiss-ip": { "command": "uvx", "args": [ "swiss-ip-mcp" ], "env": { "IGE_USERNAME": "your-value", "IGE_PASSWORD": "your-value" } } } } 3) Dime la ruta completa del archivo que vas a cambiar o el comando que vas a ejecutar y espera mi visto bueno. 4) En IGE_USERNAME, IGE_PASSWORD deja "your-value" y dime que pegue yo el valor real en el archivo o en el campo de la app. Nunca me pidas escribir una clave en el chat. 5) Haz lo acordado y comprueba que las herramientas de Swiss Ip MCP aparecen de verdad.Este mensaje no lleva tu clave. Si hace falta una, la IA te pedirá que la pegues tú en el archivo o en el campo de la app.
¿Ya está instalado? Compruébalo primero · Abre la Terminal, escribe este comando y pulsa Enter
uv --versionMac: pulsa ⌘ + Espacio, escribe Terminal y pulsa Enter
Windows: abre Inicio, escribe Windows PowerShell y elige Abrir
Si no está instalado: uv no tiene instalador de clics. Copia el comando de una línea para tu sistema (macOS o Windows) desde la página oficial de uv y pégalo en la Terminal · no hace falta instalar Python aparte; uv lo descarga cuando lo necesita
Abrir la página de descarga de uv ↗
Al terminar, cierra la Terminal, ábrela de nuevo y ejecuta el mismo comando. Debe aparecer un número de versión: uv --version
Se instala una vez y sirve para todo lo que usa uv
Abre el sitio del autor, crea una cuenta y una clave de API para el siguiente paso. Consulta precios y planes gratis en su sitio.
SettingsDeveloperEdit Config
{
"mcpServers": {
"swiss-ip": {
"command": "uvx",
"args": [
"swiss-ip-mcp"
],
"env": {
"IGE_USERNAME": "your-value",
"IGE_PASSWORD": "your-value"
}
}
}
}Pega la clave solo en el campo de la app; nunca en un chat ni se la envíes a nadie
Usa Swiss Ip MCP y dime qué puedes hacer por mí; luego muéstrame una cosa✓ Si Claude dice que está usando Swiss Ip MCP o muestra una herramienta de Swiss Ip MCP en la respuesta, ya está conectado
Nombres de menú comprobados con la ayuda de Anthropic el 11 nov 2026 · tu pantalla puede variar un poco según la versión
ChatGPT todavía no puede conectar Swiss Ip MCP
Swiss Ip MCP se instala en tu computadora, pero ChatGPT solo conecta servidores que funcionan en la web
A · Usa una app que pueda conectar Swiss Ip MCP
B · Otros en Derecho y datos públicos que funcionan con ChatGPT
Elegidos entre los más usados de la misma categoría, solo los que se conectan con una dirección y sin clave
Funciona con Claude Code, pero hay que preparar algo antes
Necesitas una clave de Swiss Ip MCP (créala en el sitio del autor) · Instala Python (uv) en tu computadora primero (una sola vez)
Copia este mensaje en un chat de Claude Code. La IA revisa tu equipo, te dice qué archivo va a cambiar y espera tu visto bueno cada vez.
Instala el MCP server Swiss Ip MCP para Claude Code en este equipo, en este orden: 1) Comprueba uv con uv --version. Si falta, dime que lo instale desde https://docs.astral.sh/uv/getting-started/installation/; no lo instales tú. 2) Usa solo esta configuración (ya revisada por PopNx MCP): claude mcp add --scope user swiss-ip --env IGE_USERNAME=your-value --env IGE_PASSWORD=your-value -- uvx swiss-ip-mcp 3) Dime la ruta completa del archivo que vas a cambiar o el comando que vas a ejecutar y espera mi visto bueno. 4) En IGE_USERNAME, IGE_PASSWORD deja "your-value" y dime que pegue yo el valor real en el archivo o en el campo de la app. Nunca me pidas escribir una clave en el chat. 5) Haz lo acordado y comprueba que las herramientas de Swiss Ip MCP aparecen de verdad.Este mensaje no lleva tu clave. Si hace falta una, la IA te pedirá que la pegues tú en el archivo o en el campo de la app.
¿Ya está instalado? Compruébalo primero · Abre la Terminal, escribe este comando y pulsa Enter
uv --versionMac: pulsa ⌘ + Espacio, escribe Terminal y pulsa Enter
Windows: abre Inicio, escribe Windows PowerShell y elige Abrir
Si no está instalado: uv no tiene instalador de clics. Copia el comando de una línea para tu sistema (macOS o Windows) desde la página oficial de uv y pégalo en la Terminal · no hace falta instalar Python aparte; uv lo descarga cuando lo necesita
Abrir la página de descarga de uv ↗
Al terminar, cierra la Terminal, ábrela de nuevo y ejecuta el mismo comando. Debe aparecer un número de versión: uv --version
Se instala una vez y sirve para todo lo que usa uv
Abre el sitio del autor, crea una cuenta y una clave de API para el siguiente paso. Consulta precios y planes gratis en su sitio.
Mac: pulsa Command+Espacio y escribe Terminal · Windows: abre PowerShell
claude mcp add --scope user swiss-ip --env IGE_USERNAME=your-value --env IGE_PASSWORD=your-value -- uvx swiss-ip-mcpCambia “your-value” por tu clave antes de pulsar Enter
Pega la clave solo en el campo de la app; nunca en un chat ni se la envíes a nadie
Deberías ver Swiss Ip MCP en la lista como conectado
Usa Swiss Ip MCP y dime qué puedes hacer por mí; luego muéstrame una cosa✓ Si Claude Code dice que está usando Swiss Ip MCP o muestra una herramienta de Swiss Ip MCP en la respuesta, ya está conectado
Nombres de menú comprobados con la ayuda de Anthropic el 11 nov 2026 · tu pantalla puede variar un poco según la versión
Funciona con Cursor, pero hay que preparar algo antes
Necesitas una clave de Swiss Ip MCP (créala en el sitio del autor) · Instala Python (uv) en tu computadora primero (una sola vez)
Copia este mensaje en un chat de Cursor. La IA revisa tu equipo, te dice qué archivo va a cambiar y espera tu visto bueno cada vez.
Instala el MCP server Swiss Ip MCP para Cursor en este equipo, en este orden: 1) Comprueba uv con uv --version. Si falta, dime que lo instale desde https://docs.astral.sh/uv/getting-started/installation/; no lo instales tú. 2) Usa solo esta configuración (ya revisada por PopNx MCP): { "mcpServers": { "swiss-ip": { "command": "uvx", "args": [ "swiss-ip-mcp" ], "env": { "IGE_USERNAME": "your-value", "IGE_PASSWORD": "your-value" } } } } 3) Dime la ruta completa del archivo que vas a cambiar o el comando que vas a ejecutar y espera mi visto bueno. 4) En IGE_USERNAME, IGE_PASSWORD deja "your-value" y dime que pegue yo el valor real en el archivo o en el campo de la app. Nunca me pidas escribir una clave en el chat. 5) Haz lo acordado y comprueba que las herramientas de Swiss Ip MCP aparecen de verdad.Este mensaje no lleva tu clave. Si hace falta una, la IA te pedirá que la pegues tú en el archivo o en el campo de la app.
¿Ya está instalado? Compruébalo primero · Abre la Terminal, escribe este comando y pulsa Enter
uv --versionMac: pulsa ⌘ + Espacio, escribe Terminal y pulsa Enter
Windows: abre Inicio, escribe Windows PowerShell y elige Abrir
Si no está instalado: uv no tiene instalador de clics. Copia el comando de una línea para tu sistema (macOS o Windows) desde la página oficial de uv y pégalo en la Terminal · no hace falta instalar Python aparte; uv lo descarga cuando lo necesita
Abrir la página de descarga de uv ↗
Al terminar, cierra la Terminal, ábrela de nuevo y ejecuta el mismo comando. Debe aparecer un número de versión: uv --version
Se instala una vez y sirve para todo lo que usa uv
Abre el sitio del autor, crea una cuenta y una clave de API para el siguiente paso. Consulta precios y planes gratis en su sitio.
En la configuración de Swiss Ip MCP, IGE_USERNAME, IGE_PASSWORD está vacío; añade tu clave y guarda
Pega la clave solo en el campo de la app; nunca en un chat ni se la envíes a nadie
Usa Swiss Ip MCP y dime qué puedes hacer por mí; luego muéstrame una cosa✓ Si Cursor dice que está usando Swiss Ip MCP o muestra una herramienta de Swiss Ip MCP en la respuesta, ya está conectado
Nombres de menú comprobados con la ayuda de Cursor el 11 nov 2026 · tu pantalla puede variar un poco según la versión
Funciona con VS Code, pero hay que preparar algo antes
Necesitas una clave de Swiss Ip MCP (créala en el sitio del autor) · Instala Python (uv) en tu computadora primero (una sola vez)
Copia este mensaje en un chat de VS Code. La IA revisa tu equipo, te dice qué archivo va a cambiar y espera tu visto bueno cada vez.
Instala el MCP server Swiss Ip MCP para VS Code en este equipo, en este orden: 1) Comprueba uv con uv --version. Si falta, dime que lo instale desde https://docs.astral.sh/uv/getting-started/installation/; no lo instales tú. 2) Usa solo esta configuración (ya revisada por PopNx MCP): { "servers": { "swiss-ip": { "type": "stdio", "command": "uvx", "args": [ "swiss-ip-mcp" ], "env": { "IGE_USERNAME": "your-value", "IGE_PASSWORD": "your-value" } } } } 3) Dime la ruta completa del archivo que vas a cambiar o el comando que vas a ejecutar y espera mi visto bueno. 4) En IGE_USERNAME, IGE_PASSWORD deja "your-value" y dime que pegue yo el valor real en el archivo o en el campo de la app. Nunca me pidas escribir una clave en el chat. 5) Haz lo acordado y comprueba que las herramientas de Swiss Ip MCP aparecen de verdad.Este mensaje no lleva tu clave. Si hace falta una, la IA te pedirá que la pegues tú en el archivo o en el campo de la app.
¿Ya está instalado? Compruébalo primero · Abre la Terminal, escribe este comando y pulsa Enter
uv --versionMac: pulsa ⌘ + Espacio, escribe Terminal y pulsa Enter
Windows: abre Inicio, escribe Windows PowerShell y elige Abrir
Si no está instalado: uv no tiene instalador de clics. Copia el comando de una línea para tu sistema (macOS o Windows) desde la página oficial de uv y pégalo en la Terminal · no hace falta instalar Python aparte; uv lo descarga cuando lo necesita
Abrir la página de descarga de uv ↗
Al terminar, cierra la Terminal, ábrela de nuevo y ejecuta el mismo comando. Debe aparecer un número de versión: uv --version
Se instala una vez y sirve para todo lo que usa uv
Abre el sitio del autor, crea una cuenta y una clave de API para el siguiente paso. Consulta precios y planes gratis en su sitio.
En la configuración de Swiss Ip MCP, IGE_USERNAME, IGE_PASSWORD está vacío; añade tu clave y guarda
Pega la clave solo en el campo de la app; nunca en un chat ni se la envíes a nadie
Usa Swiss Ip MCP y dime qué puedes hacer por mí; luego muéstrame una cosa✓ Si VS Code dice que está usando Swiss Ip MCP o muestra una herramienta de Swiss Ip MCP en la respuesta, ya está conectado
Nombres de menú comprobados con la ayuda de VS Code el 11 nov 2026 · tu pantalla puede variar un poco según la versión
Otras apps que usan MCP, como Windsurf, Zed o Gemini CLI, añaden servidores de forma distinta. Míralo en la lista de apps
Ver todas las apps que usan MCP →
La configuración JSON está en “Para desarrolladores”, abajo
Claude Code
claude mcp add --scope user swiss-ip --env IGE_USERNAME=your-value --env IGE_PASSWORD=your-value -- uvx swiss-ip-mcpClaude Desktop (claude_desktop_config.json)
{
"mcpServers": {
"swiss-ip": {
"command": "uvx",
"args": [
"swiss-ip-mcp"
],
"env": {
"IGE_USERNAME": "your-value",
"IGE_PASSWORD": "your-value"
}
}
}
}Cursor (~/.cursor/mcp.json)
{
"mcpServers": {
"swiss-ip": {
"command": "uvx",
"args": [
"swiss-ip-mcp"
],
"env": {
"IGE_USERNAME": "your-value",
"IGE_PASSWORD": "your-value"
}
}
}
}VS Code (mcp.json)
{
"servers": {
"swiss-ip": {
"type": "stdio",
"command": "uvx",
"args": [
"swiss-ip-mcp"
],
"env": {
"IGE_USERNAME": "your-value",
"IGE_PASSWORD": "your-value"
}
}
}
}IGE_USERNAME secreto obligatorio envIGE_PASSWORD secreto obligatorio envDescripciones traducidas automáticamente; los nombres de variables quedan como en el original. Si dudas, mira el original.
Esta configuración se genera a partir de la ficha del creador en el registro. Si el README dice otra cosa, sigue el README.
pypi: swiss-ip-mcpSegún cómo se conecta este servidor y la documentación de cada app, comprobado el 10 nov 2026.
Se ejecutan en tu computadora en
ClaudeGooseLM StudioMsty StudioCherry StudioCursorVS Code + GitHub CopilotVisual StudioWindsurf (Devin Desktop)ZedKiroClineContinueJetBrains AI AssistantClaude CodeCodex CLIGemini CLIOpenCodenodecodeWarpLibreChatRaycast
Se ejecuta en tu computadora; la lista de herramientas aparece en tu app de IA después de instalarlo.
Revisamos información que cualquiera puede ver; no hemos leído el código. Las revisiones que no aplican no se cuentan. · Revisado el 19 nov 2026
El nombre en el registro se verificó con la cuenta de GitHub malkreide, dueña del repo
Último cambio de código: hace 18 días
Usa MIT
Este se ejecuta en tu computadora; no hay endpoint en internet
Se ejecuta en tu computadora y usa ajustes locales en su lugar
Se ejecuta en tu computadora; solo podemos leer listas de herramientas de endpoints en internet
Sin entradas en OSV.dev para swiss-ip-mcp@1.2.0
Solo revisa esta versión del paquete, no todas sus dependencias · revisado 15 nov 2026
Si lo creaste tú, pega este código en tu README. La insignia enlaza a esta página.
[](https://mcp.popnx.com/en/servers/malkreide-swiss-ip-mcp)Pregunta, comparte un consejo o avisa de que no funciona. Ordenado por lo que la gente marcó como útil.
Aún no hay publicaciones. Sé la primera persona en preguntar o compartir.
Lo publicado aquí lo escriben usuarios, no el equipo de PopNx.
Aún no hay reseñas
Comparado con todos los servidores activos de esta categoría en el registro. Las estrellas solo cuentan cuando quien lo publica es dueño del repo.
Superó 3 de 3 revisiones básicas aplicables. No hemos leído el código. Antes de agregar una clave o un token, revisa qué acceso pide el servidor y usa una clave que tenga solo los permisos que necesitas.
Debes completar: IGE_USERNAME, IGE_PASSWORD
Se ejecuta en tu computadora. Tu app de IA lo inicia cuando hace falta, y los datos no pasan por los servidores del creador (a menos que el propio servidor llame a un servicio en línea).
El repo de GitHub cambió por última vez hace 18 días, y la última versión (1.2.0) llegó al registro hace 2 meses.
Las apps compatibles con MCP, como Claude Desktop, Claude Code, Cursor y VS Code. También necesitas Python (uv) en tu computadora.
En la misma categoría: Global law, Open Legal Data (Germany), LibreJustice, InfraNode, Fedlex Connector
Misma categoría, otros creadores, comandos ya revisados. Primero los oficiales, luego por estrellas.
Cómo leer una tarjeta:↓ Descargas por semanai★ Estrellas de GitHubiTres pilares: reseñas · revisiones · usoiActualizado = fecha en que se publicó la última versión en el registroi
The law of nearly every country on earth, any date: read it, see what changed it, check citations.
German court decisions (Rechtsprechung) and laws (Gesetze) with citation graph and citation checks.
Search French-language and European case law and French legal texts (codes, statutes, treaties).
Keyless open data for 84 German cities: 12 lean read-only MCP tools covering 67 data types.
Search Swiss federal legislation: laws, articles, amendments via the Fedlex SPARQL endpoint.
| Este Swiss Ip MCP | Global law | Open Legal Data (Germany) | LibreJustice | InfraNode | Fedlex Connector | |
|---|---|---|---|---|---|---|
| Dónde se ejecuta | Se instala en tu equipo | Funciona en la nube, sin instalar nada | Funciona en la nube, sin instalar nada | Funciona en la nube, sin instalar nada | Funciona en la nube, sin instalar nada | Funciona en la nube, sin instalar nada |
| Necesita clave | Sí | No | No | No | No | No |
| Se añade con + en Claude | No | No | No | No | No | No |
| Revisiones básicas | 3/3 | 4/4 | 4/4 | 4/4 | 4/4 | 4/4 |
| Licencia | MIT | NOASSERTION | MIT | Apache-2.0 | Apache-2.0 | MIT |
| Precio | Sin coste en el registro | Sin coste en el registro | Sin coste en el registro | Sin coste en el registro | Sin coste en el registro | Sin coste en el registro |
Copiado tal cual del repo del creador. PopNx MCP no lo ha revisado ni lo respalda. Se quitaron HTML, imágenes y scripts. Los enlaces llevan fuera de este sitio.
🇨🇭 Part of the [Swiss Public Data MCP Portfolio](https://github.com/malkreide/swiss-public-data-mcp)
MCP Server for Swiss Intellectual Property Data (IGE/IPI)
🇩🇪 Deutsche Version → README.de.md
swiss-ip-mcp is a Model Context Protocol (MCP) server that gives AI models structured, language-driven access to the Swiss intellectual property register Swissreg, operated by the Swiss Federal Institute of Intellectual Property (IGE/IPI).
It is the successor to patent-mcp and covers all available domains of the Swissreg Datadelivery API: trademarks, patents, patent publications, and supplementary protection certificates (SPC/ESZ).
This server is model-agnostic. It works with Claude, GPT-4, Llama, and any other MCP-compatible client – not just Claude Desktop.
The real power is natural language. Instead of manually searching the register, just ask a question:
"Which trademarks does the City of Zurich hold at the IGE?"
"Is the name 'Learning City Zurich' registered as a trademark in Switzerland?"
"Which pharmaceutical companies have filed Swiss patents in the last six months?"
"Show me all trademark applications in the education sector (Nice class 41) since January 2025."
"What supplementary protection certificates does Novartis hold in Switzerland?"
| Domain | Description |
|---|---|
| Trademarks | Swiss trademark register – filing, protection, owners, Nice classes |
| Patents | CH patents – filing, grant, IPC classes, applicants, inventors |
| Patent publications | Official patent publications in the Swiss Official Gazette |
| SPC / ESZ | Supplementary protection certificates for medicinal and plant-protection products |
Note: Design search is not yet available in the Swissreg Datadelivery API.
| Tool | Function |
|---|---|
swiss_ip_search_trademarks | Free-text trademark search (wildcard * supported) |
swiss_ip_get_trademark | Retrieve a trademark by registration number |
swiss_ip_search_trademarks_by_owner | Find all trademarks held by a given owner |
swiss_ip_search_trademarks_by_class | Filter trademarks by Nice classification class |
swiss_ip_search_patents | Free-text patent search |
swiss_ip_get_patent | Retrieve a patent by number |
swiss_ip_search_patents_by_applicant | Find patents by applicant or inventor name |
swiss_ip_search_patent_publications | Search patent publications |
swiss_ip_search_spc | SPC/ESZ search (pharma and plant protection) |
swiss_ip_search_recent_filings | Filter filings by date range across all domains |
swiss_ip_get_quota | Check remaining API data transfer quota |
Beyond tools, the server exposes two more MCP primitives:
Resources (read-only metadata, swissip:// URI scheme):
| URI | Content |
|---|---|
swissip://about | Server + data-source metadata (provenance, covered domains) |
swissip://domains | List of covered IP domains |
Prompts (curated workflow templates):
| Prompt | Arguments | Purpose |
|---|---|---|
trademark_availability | name | Check whether a name is a registered Swiss trademark |
competitor_ip_report | company | IP overview (trademarks + patents) for a company |
recent_ip_filings_report | ip_type, date_from, date_to | Report on recent filings in a period |
Tool execution errors (API failures, timeouts, missing credentials) are returned with MCP isError: true and a masked, user-friendly message — internal details (stack traces, raw API bodies) go only to the server log. A specific number lookup that finds nothing is not an error: it returns a normal result with match_type: "none" and a message.
This server is in Phase 1 (read-only) of the MCP phased-rollout model: every tool is read-only and writes nothing. See ROADMAP.md for the phase plan and the prerequisites for any future write-capable phase.
AI client (Claude Desktop, Cursor, VS Code + Continue, …)
│ │ MCP (stdio or SSE) ▼ swiss-ip-mcp │ │ HTTPS + OAuth2 (IGE IDP) ▼ Swissreg Datadelivery API https://www.swissreg.ch/public/api/v1 │ ├── TrademarkSearch ├── PatentSearch ├── PatentPublicationSearch ├── SPCSearch └── UserQuota
| Transport | Use case | Configuration |
|---|---|---|
| stdio | Claude Desktop, local development | Default (no extra setup) |
| Streamable HTTP | Cloud deployment (Render.com etc.) | MCP_TRANSPORT=streamable-http |
| SSE | Legacy HTTP clients — *deprecated* | MCP_TRANSPORT=sse |
SSE is deprecated. Protocol revision
2026-07-28reclassified the
HTTP+SSE transport as Deprecated under the feature lifecycle policy (SEP-2596;
it had been soft-deprecated since
2025-03-26). It stays available here for
the twelve-month deprecation window — new deployments should use
MCP_TRANSPORT=streamable-http.
Transport is selected at startup from the MCP_TRANSPORT environment variable (default stdio). The HTTP transports are served by uvicorn and honour:
| Variable | Default | Purpose |
|---|---|---|
MCP_HOST | 127.0.0.1 | Bind address. Use 0.0.0.0 only inside a container / behind a reverse proxy. |
PORT / MCP_PORT | 8000 | Bind port (PORT wins — PaaS convention). |
MCP_ALLOWED_ORIGINS | _(empty)_ | Comma-separated CORS origin allow-list. No wildcard in production. |
MCP_ALLOWED_HOSTS | _(empty)_ | Comma-separated Host-header allow-list; enables DNS-rebinding protection when set. |
The Mcp-Session-Id header is exposed via CORS so browser-based clients can read and echo it on follow-up requests.
pip# Run directly with uv (recommended, no local installation needed)
uvx swiss-ip-mcp
git clone https://github.com/malkreide/swiss-ip-mcp cd swiss-ip-mcp pip install -e ".[dev]"
export IGE_USERNAME="your_username"
export IGE_PASSWORD="your_password"
Open the config file:
~/Library/Application Support/Claude/claude_desktop_config.json%APPDATA%\Claude\claude_desktop_config.json{
"mcpServers": { "swiss-ip": { "command": "uvx", "args": ["swiss-ip-mcp"], "env": { "IGE_USERNAME": "your_username", "IGE_PASSWORD": "your_password" } } } }
swiss-ip-mcp is compatible with any MCP-capable client:
| Client | Configuration |
|---|---|
| Cursor | Add to ~/.cursor/mcp.json (same format as Claude Desktop) |
| VS Code + Continue | Add via continue.json MCP server block |
| Windsurf | Add via MCP server settings |
| Self-hosted (mcp-proxy) | Use SSE transport with MCP_TRANSPORT=sse |
MCP_TRANSPORT=streamable-http \
MCP_HOST=0.0.0.0 PORT=8000 \ MCP_ALLOWED_ORIGINS="https://your-client.example" \ MCP_ALLOWED_HOSTS="your-app.onrender.com" \ IGE_USERNAME=... IGE_PASSWORD=... \ swiss-ip-mcp
Security note: bind to
0.0.0.0only inside a container or behind a
reverse proxy. Always set
MCP_ALLOWED_ORIGINSandMCP_ALLOWED_HOSTSfor
public deployments — this enables CORS scoping and DNS-rebinding protection.
The endpoint is unauthenticated and serves only public IP-register data; do
not place credentialed or non-public tools behind this transport without
adding authentication first.
A hardened multi-stage Dockerfile (non-root UID 10001, HEALTHCHECK on /health), a docker-compose.yml with resource limits, and Kubernetes manifests + an HAProxy sticky-session config under deploy/ are included.
docker compose up --build # reads IGE_* from .env
See docs/deployment.md for hardening, resource limits and scaling (stateless vs. sticky-session) details.
# Unit tests (no credentials needed)
PYTHONPATH=src pytest tests/ -v
IGE_USERNAME=... IGE_PASSWORD=... PYTHONPATH=src pytest tests/ -v
The CI workflow runs on Python 3.11, 3.12, and 3.13.
The server can emit OpenTelemetry traces — one span per tool call plus child spans for the backend Swissreg/IDP HTTP calls. Tracing is off by default and adds no overhead until enabled.
pip install 'swiss-ip-mcp[otel]'
MCP_OTEL_ENABLED=1 \ OTEL_EXPORTER_OTLP_ENDPOINT=http://your-collector:4318 \ MCP_ENV=production \ swiss-ip-mcp
| Variable | Purpose |
|---|---|
MCP_OTEL_ENABLED | Set to 1 to enable trace export (or just set the endpoint below). |
OTEL_EXPORTER_OTLP_ENDPOINT | OTLP/HTTP collector endpoint (standard OTEL variable). |
MCP_ENV | Value for the deployment.environment resource attribute (default production). |
Tool spans carry only mcp.tool.name and mcp.tool.result.is_error — no query arguments, credentials or response bodies are recorded.
The server logs structured JSON to stderr (stdout is reserved for the stdio protocol). Every tool call binds a tool name and a correlation_id, so all log lines for one call are correlated. Set the level with LOG_LEVEL (DEBUG / INFO / WARNING / ERROR, default INFO):
{"event": "tool.call.start", "tool": "swiss_ip_search_trademarks", "correlation_id": "da55…", "level": "info", "timestamp": "…Z"}
This server speaks two protocol eras over the same endpoint. The client's first request on a connection decides which one applies; a later claim from the other era is refused.
| Era | Revision | Who reaches it |
|---|---|---|
initialize handshake | 2024-11-05 … `2025-11-25` | What today's clients speak. The server answers with the revision asked for, or with the 2025-11-25 ceiling when the request asks for something newer. |
| Per-request envelope | `2026-07-28` | A request carrying the 2026-07-28 _meta envelope opens a modern connection. |
Both revisions are pinned in tests/test_protocol_version.py and asserted against the installed SDK, so a Dependabot bump of mcp cannot move either one silently.
On top of that, tests/test_modern_era.py measures both eras: it sends re