Prototype · Preview: every server in the official registry, synced every 30 minutes. Sign in with Google to write reviews.Prototype · updated every 30 min
PopNx MCPMCP servers for people who use AI · explained in plain words

Swiss Ip MCP

by malkreideversion 1.2.0i★ 0iRuns on your computerRepository ↗
Registry nameio.github.malkreide/swiss-ip-mcp

How to install

What it does

IGE/IPI Swissreg trademarks, patents, SPCs

  • Connects Runs on your computer
  • Account or key Needs IGE_USERNAME, IGE_PASSWORD
  • Category Law & government data

Why it ranks here

Lists are ordered by a usage score (out of 100) built from these parts

Popularity0/80GitHub stars or weekly downloads: the larger counts 60, the smaller 20
Freshness12/12Full marks for a release or code change within 30 days
Still answering0/8The cloud endpoint answered at the last check
Usage score12/100

Quality: Passed 3/3 basic checks (shown, not used for ordering) · Momentum: No data yet (Used only on the Trending tab)

Install

Pick the AI app you use, then copy the settings.

Let your AI install it with one sentence

Please install Swiss Ip MCP. Follow https://mcp.popnx.com/i/malkreide-swiss-ip-mcp.md, show me the commands and wait for my OK before running them.

Paste it into an AI that can work on your computer (such as Claude Code or Cursor). It reads our steps, shows you the commands and waits for your OK. No key, no sign-up. · See the full text your AI reads

Passed 3/3 checks · Runs on your computer · ✓ Commands checked Nov 13, 2026

First: which AI do you use?

Pick your app and the steps appear below.

Works with Claude, with some setup first

You need a Swiss Ip MCP key (create it on the maker’s site) · Install Python (uv) on your computer first (one time) · Only the Claude desktop app (Windows or Mac), not the web or phone

Let AI install it

Copy this message into a Claude chat. The AI checks your computer, tells you which file it will change, and waits for your OK every time.

Please install the MCP server Swiss Ip MCP for Claude on this computer, in this order: 1) Check uv with uv --version. If it is missing, tell me to install it from https://docs.astral.sh/uv/getting-started/installation/; do not install it yourself. 2) Use only this config (already checked by PopNx MCP): { "mcpServers": { "swiss-ip": { "command": "uvx", "args": [ "swiss-ip-mcp" ], "env": { "IGE_USERNAME": "your-value", "IGE_PASSWORD": "your-value" } } } } 3) Tell me the full path of the file you will change, or the command you will run, and wait for my OK. 4) For IGE_USERNAME, IGE_PASSWORD, leave "your-value" in place and tell me to paste the real value myself into the file or the app’s field. Never ask me to type a key in chat. 5) Do what we agreed, then check that the Swiss Ip MCP tools really show up.

This message has no key in it. If a key is needed, the AI will ask you to paste it yourself into the file or the app’s field.

  1. Install uv (if you don’t have it)

    Already installed? Check first · Open Terminal, type this command and press Enter

    uv --version
    • A version number such as uv … = installed, skip this step
    • "command not found" (on Windows: "is not recognized") = not installed yet, or installed but Terminal needs to be closed and reopened
    How to open Terminal

    Mac: press ⌘ + Space, type Terminal, press Enter

    Windows: open Start, type Windows PowerShell, then Open

    Not installed: uv has no click-through installer. Copy the one-line command for your system (macOS or Windows) from uv’s official page into Terminal · no separate Python install needed; uv downloads it when required

    Open the uv download page ↗

    When it’s done, close Terminal, open it again and run the same command. You should see a version number: uv --version

    Install once; it works for everything that needs uv

  2. Sign up and create a Swiss Ip MCP key

    Open the maker’s site, sign up and create an API key for the next step. Check the maker’s site for pricing and free plans.

    Open the Swiss Ip MCP site ↗

  3. Open the Claude desktop app’s settings file

    SettingsDeveloperEdit Config

  4. Paste these settings and save the file

    {
      "mcpServers": {
        "swiss-ip": {
          "command": "uvx",
          "args": [
            "swiss-ip-mcp"
          ],
          "env": {
            "IGE_USERNAME": "your-value",
            "IGE_PASSWORD": "your-value"
          }
        }
      }
    }

    Paste the key only into the app’s field, never into a chat or to anyone

  5. Quit Claude and open it again

  6. Try it

    Use Swiss Ip MCP and tell me what you can do for me, then show me one thing

    ✓ If Claude says it is using Swiss Ip MCP or shows a Swiss Ip MCP tool in the answer, you are connected

Menu names checked against Anthropic’s help page on Nov 11, 2026 · your screen may differ slightly by app version

ChatGPT cannot connect Swiss Ip MCP yet

Swiss Ip MCP runs on your computer, but ChatGPT can only connect servers that run on the web

What you can do instead

A · Use an app that can connect Swiss Ip MCP

  • You need a Swiss Ip MCP key (create it on the maker’s site) · Install Python (uv) on your computer first (one time) · Only the Claude desktop app (Windows or Mac), not the web or phone
  • You need a Swiss Ip MCP key (create it on the maker’s site) · Install Python (uv) on your computer first (one time)
  • You need a Swiss Ip MCP key (create it on the maker’s site) · Install Python (uv) on your computer first (one time)
  • You need a Swiss Ip MCP key (create it on the maker’s site) · Install Python (uv) on your computer first (one time)

B · Others in Law & government data that work with ChatGPT

Picked from the most used in the same category, only ones that connect by address with no key

Works with Claude Code, with some setup first

You need a Swiss Ip MCP key (create it on the maker’s site) · Install Python (uv) on your computer first (one time)

Let AI install it

Copy this message into a Claude Code chat. The AI checks your computer, tells you which file it will change, and waits for your OK every time.

Please install the MCP server Swiss Ip MCP for Claude Code on this computer, in this order: 1) Check uv with uv --version. If it is missing, tell me to install it from https://docs.astral.sh/uv/getting-started/installation/; do not install it yourself. 2) Use only this config (already checked by PopNx MCP): claude mcp add --scope user swiss-ip --env IGE_USERNAME=your-value --env IGE_PASSWORD=your-value -- uvx swiss-ip-mcp 3) Tell me the full path of the file you will change, or the command you will run, and wait for my OK. 4) For IGE_USERNAME, IGE_PASSWORD, leave "your-value" in place and tell me to paste the real value myself into the file or the app’s field. Never ask me to type a key in chat. 5) Do what we agreed, then check that the Swiss Ip MCP tools really show up.

This message has no key in it. If a key is needed, the AI will ask you to paste it yourself into the file or the app’s field.

  1. Install uv (if you don’t have it)

    Already installed? Check first · Open Terminal, type this command and press Enter

    uv --version
    • A version number such as uv … = installed, skip this step
    • "command not found" (on Windows: "is not recognized") = not installed yet, or installed but Terminal needs to be closed and reopened
    How to open Terminal

    Mac: press ⌘ + Space, type Terminal, press Enter

    Windows: open Start, type Windows PowerShell, then Open

    Not installed: uv has no click-through installer. Copy the one-line command for your system (macOS or Windows) from uv’s official page into Terminal · no separate Python install needed; uv downloads it when required

    Open the uv download page ↗

    When it’s done, close Terminal, open it again and run the same command. You should see a version number: uv --version

    Install once; it works for everything that needs uv

  2. Sign up and create a Swiss Ip MCP key

    Open the maker’s site, sign up and create an API key for the next step. Check the maker’s site for pricing and free plans.

    Open the Swiss Ip MCP site ↗

  3. Open Terminal

    Mac: press Command+Space and type Terminal · Windows: open PowerShell

  4. Paste this command and press Enter

    claude mcp add --scope user swiss-ip --env IGE_USERNAME=your-value --env IGE_PASSWORD=your-value -- uvx swiss-ip-mcp

    Replace “your-value” with your key before pressing Enter

    Paste the key only into the app’s field, never into a chat or to anyone

  5. Type /mcp in Claude Code

    You should see Swiss Ip MCP listed as connected

  6. Try it

    Use Swiss Ip MCP and tell me what you can do for me, then show me one thing

    ✓ If Claude Code says it is using Swiss Ip MCP or shows a Swiss Ip MCP tool in the answer, you are connected

Menu names checked against Anthropic’s help page on Nov 11, 2026 · your screen may differ slightly by app version

Works with Cursor, with some setup first

You need a Swiss Ip MCP key (create it on the maker’s site) · Install Python (uv) on your computer first (one time)

Let AI install it

Copy this message into a Cursor chat. The AI checks your computer, tells you which file it will change, and waits for your OK every time.

Please install the MCP server Swiss Ip MCP for Cursor on this computer, in this order: 1) Check uv with uv --version. If it is missing, tell me to install it from https://docs.astral.sh/uv/getting-started/installation/; do not install it yourself. 2) Use only this config (already checked by PopNx MCP): { "mcpServers": { "swiss-ip": { "command": "uvx", "args": [ "swiss-ip-mcp" ], "env": { "IGE_USERNAME": "your-value", "IGE_PASSWORD": "your-value" } } } } 3) Tell me the full path of the file you will change, or the command you will run, and wait for my OK. 4) For IGE_USERNAME, IGE_PASSWORD, leave "your-value" in place and tell me to paste the real value myself into the file or the app’s field. Never ask me to type a key in chat. 5) Do what we agreed, then check that the Swiss Ip MCP tools really show up.

This message has no key in it. If a key is needed, the AI will ask you to paste it yourself into the file or the app’s field.

  1. Install uv (if you don’t have it)

    Already installed? Check first · Open Terminal, type this command and press Enter

    uv --version
    • A version number such as uv … = installed, skip this step
    • "command not found" (on Windows: "is not recognized") = not installed yet, or installed but Terminal needs to be closed and reopened
    How to open Terminal

    Mac: press ⌘ + Space, type Terminal, press Enter

    Windows: open Start, type Windows PowerShell, then Open

    Not installed: uv has no click-through installer. Copy the one-line command for your system (macOS or Windows) from uv’s official page into Terminal · no separate Python install needed; uv downloads it when required

    Open the uv download page ↗

    When it’s done, close Terminal, open it again and run the same command. You should see a version number: uv --version

    Install once; it works for everything that needs uv

  2. Sign up and create a Swiss Ip MCP key

    Open the maker’s site, sign up and create an API key for the next step. Check the maker’s site for pricing and free plans.

    Open the Swiss Ip MCP site ↗

  3. Click this button to open Cursor

    Open in Cursor

    Cursor asks you to confirm; click Install

  4. Fill in your key

    In the Swiss Ip MCP settings, IGE_USERNAME, IGE_PASSWORD is empty; add your key and save

    Paste the key only into the app’s field, never into a chat or to anyone

  5. Open the AI chat in Cursor in Agent mode

  6. Try it

    Use Swiss Ip MCP and tell me what you can do for me, then show me one thing

    ✓ If Cursor says it is using Swiss Ip MCP or shows a Swiss Ip MCP tool in the answer, you are connected

Menu names checked against Cursor’s help page on Nov 11, 2026 · your screen may differ slightly by app version

Works with VS Code, with some setup first

You need a Swiss Ip MCP key (create it on the maker’s site) · Install Python (uv) on your computer first (one time)

Let AI install it

Copy this message into a VS Code chat. The AI checks your computer, tells you which file it will change, and waits for your OK every time.

Please install the MCP server Swiss Ip MCP for VS Code on this computer, in this order: 1) Check uv with uv --version. If it is missing, tell me to install it from https://docs.astral.sh/uv/getting-started/installation/; do not install it yourself. 2) Use only this config (already checked by PopNx MCP): { "servers": { "swiss-ip": { "type": "stdio", "command": "uvx", "args": [ "swiss-ip-mcp" ], "env": { "IGE_USERNAME": "your-value", "IGE_PASSWORD": "your-value" } } } } 3) Tell me the full path of the file you will change, or the command you will run, and wait for my OK. 4) For IGE_USERNAME, IGE_PASSWORD, leave "your-value" in place and tell me to paste the real value myself into the file or the app’s field. Never ask me to type a key in chat. 5) Do what we agreed, then check that the Swiss Ip MCP tools really show up.

This message has no key in it. If a key is needed, the AI will ask you to paste it yourself into the file or the app’s field.

  1. Install uv (if you don’t have it)

    Already installed? Check first · Open Terminal, type this command and press Enter

    uv --version
    • A version number such as uv … = installed, skip this step
    • "command not found" (on Windows: "is not recognized") = not installed yet, or installed but Terminal needs to be closed and reopened
    How to open Terminal

    Mac: press ⌘ + Space, type Terminal, press Enter

    Windows: open Start, type Windows PowerShell, then Open

    Not installed: uv has no click-through installer. Copy the one-line command for your system (macOS or Windows) from uv’s official page into Terminal · no separate Python install needed; uv downloads it when required

    Open the uv download page ↗

    When it’s done, close Terminal, open it again and run the same command. You should see a version number: uv --version

    Install once; it works for everything that needs uv

  2. Sign up and create a Swiss Ip MCP key

    Open the maker’s site, sign up and create an API key for the next step. Check the maker’s site for pricing and free plans.

    Open the Swiss Ip MCP site ↗

  3. Click this button to open VS Code

    Open in VS Code

    VS Code asks you to confirm; click Install

  4. Fill in your key

    In the Swiss Ip MCP settings, IGE_USERNAME, IGE_PASSWORD is empty; add your key and save

    Paste the key only into the app’s field, never into a chat or to anyone

  5. Open the AI chat in VS Code in Agent mode

  6. Try it

    Use Swiss Ip MCP and tell me what you can do for me, then show me one thing

    ✓ If VS Code says it is using Swiss Ip MCP or shows a Swiss Ip MCP tool in the answer, you are connected

Menu names checked against VS Code’s help page on Nov 11, 2026 · your screen may differ slightly by app version

Other apps that use MCP, such as Windsurf, Zed or Gemini CLI, each add servers differently. See how in the app list.

See every app that uses MCP →

JSON settings are under “For developers” below

Stuck? Ask people who use Swiss Ip MCP💬 Discussion →
For developers: Terminal commands and JSON settings

Installed on your computer

Claude Code

claude mcp add --scope user swiss-ip --env IGE_USERNAME=your-value --env IGE_PASSWORD=your-value -- uvx swiss-ip-mcp

Claude 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"
      }
    }
  }
}

Values you fill in

  • IGE_USERNAME secret required env
    Username for the Swiss Federal Institute of Intellectual Property (IGE/IPI) Swissreg API. Issued by IGE after signing the terms of use.
  • IGE_PASSWORD secret required env
    Password for the IGE/IPI Swissreg account.

Descriptions are as written by the maker.

These settings are generated from the maker’s registry entry. If the README says otherwise, follow the README.

At a glance

Downloads per weeki
27/wk
Connection
Runs on your computer
Latest versioni
1.2.0
Published to registryi
Sep 27, 2026
Code last changedi
Nov 1, 2026
Maker
malkreide
Packages
pypi: swiss-ip-mcp
Website
github.com
Registry status
Active

Which apps can use it

Based on how this server connects and on each app’s own docs, checked Nov 10, 2026.

Run on your computer in

ClaudeGooseLM StudioMsty StudioCherry StudioCursorVS Code + GitHub CopilotVisual StudioWindsurf (Devin Desktop)ZedKiroClineContinueJetBrains AI AssistantClaude CodeCodex CLIGemini CLIOpenCodenodecodeWarpLibreChatRaycast

All apps, with pros and cons →

Related guides

What it can do

Runs on your computer; the tool list appears in your AI app after you install it.

Basic checksi

We check information anyone can see; we have not read the code. Checks that do not apply are left out of the count. · Checked Nov 19, 2026

  • ✓ Pass

    Maker matches the repo

    The registry name was verified with the GitHub account malkreide, which owns the repo

  • ✓ Pass

    Still maintained

    Code last changed 18 days ago

  • ✓ Pass

    Has a licence

    Uses MIT

  • – Not applicable

    Endpoint responds

    This one runs on your computer; there is no internet endpoint

  • – Not applicable

    Sign-in with OAuth

    Runs on your computer and uses local settings instead

  • … Not checked yet

    No hidden instructions in tool descriptions

    Runs on your computer; we can only read tool lists from internet endpoints

Published vulnerabilities (OSV.dev)

No entries on OSV.dev for swiss-ip-mcp@1.2.0

Checks only this package version, not every dependency · checked Nov 15, 2026

What we check → · JSON

Makers: ask for a re-check or report wrong info
For makers: add a badge to your README

If you made this, paste this code into your README. The badge links back to this page.

[![Featured on PopNx MCP](https://mcp.popnx.com/badge/malkreide-swiss-ip-mcp.svg)](https://mcp.popnx.com/en/servers/malkreide-swiss-ip-mcp)

Discussion

Ask, share a tip or report that it does not work. Sorted by what people marked helpful.

No posts yet. Be the first to ask or share.

Posts here are written by users, not the PopNx team.

Sign in to post

User reviews

No reviews yet

Sign in to write a review

Compared with others in Law & government datai

  • More stars than 0% of the other 1948 servers in this category
  • Published to the registry more recently than 37% of the other 1948 servers in this category
  • Basic checks equal to or better than 99% of the other 1948 servers in this category

Compared with every active server in this category in the registry. Stars count only when the publisher owns the repo.

Common questions

Is Swiss Ip MCP safe?

It passed 3 of 3 applicable basic checks. We have not read the code. Before adding a key or token, see what access the server asks for and use a key with only the permissions you need.

What keys or codes does it need?

You need to fill in: IGE_USERNAME, IGE_PASSWORD

Does it run on my computer or in the cloud?

It runs on your computer. Your AI app starts it when needed, and data does not pass through the maker’s servers (unless it calls an online service itself).

Is it still maintained?

The GitHub repo last changed 18 days ago, and the latest version (1.2.0) reached the registry 2 months ago.

Which apps can use it?

Apps that support MCP, such as Claude Desktop, Claude Code, Cursor and VS Code. You also need Python (uv) on your computer.

What can I use instead?

In the same category: Global law, Open Legal Data (Germany), LibreJustice, InfraNode, Fedlex Connector

Similar alternatives

Same category, other makers, commands already checked. Official ones first, then by stars.

Reading a card:↓ Downloads per weeki★ GitHub starsiThree pillars: reviews · checks · usageiUpdated = latest version published to the registryi

Global law

The law of nearly every country on earth, any date: read it, see what changed it, check citations.

by lexifinaWidely used★ 2.1KUpdated 9 days ago

Runs in the cloud✓ lexifina.com

LibreJustice

Search French-language and European case law and French legal texts (codes, statutes, treaties).

by librejusticeEarly★ 36Updated 2 months ago

Runs in the cloud✓ service owner · librejustice.fr

InfraNode

Keyless open data for 84 German cities: 12 lean read-only MCP tools covering 67 data types.

by street1983nkEarly★ 18Updated 5 months ago

Runs in the cloud✓ service owner · infranode.dev

Fedlex Connector

Search Swiss federal legislation: laws, articles, amendments via the Fedlex SPARQL endpoint.

by JayTheSkierEarly★ 8Updated 7 months ago

Runs in the cloud✓ service owner · fedlex-connector.ch
Compared with similar ones
This one
Swiss Ip MCP
Global lawOpen Legal Data (Germany)LibreJusticeInfraNodeFedlex Connector
Runs whereInstalls on your computerRuns in the cloud, nothing to installRuns in the cloud, nothing to installRuns in the cloud, nothing to installRuns in the cloud, nothing to installRuns in the cloud, nothing to install
Needs a keyYesNoNoNoNoNo
Add with + in ClaudeNoNoNoNoNoNo
Basic checks3/34/44/44/44/44/4
LicenseMITNOASSERTIONMITApache-2.0Apache-2.0MIT
PriceNo cost listed in the registryNo cost listed in the registryNo cost listed in the registryNo cost listed in the registryNo cost listed in the registryNo cost listed in the registry

README from the maker

Open the README

Copied from the maker’s repo as written. PopNx MCP has not reviewed or endorsed it. HTML, images and scripts are removed. Links lead off this site.

🇨🇭 Part of the [Swiss Public Data MCP Portfolio](https://github.com/malkreide/swiss-public-data-mcp)

💡 swiss-ip-mcp

MCP Server for Swiss Intellectual Property Data (IGE/IPI)

🇩🇪 Deutsche Version → README.de.md


Overview

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.


Example Queries

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?"


Covered Domains

DomainDescription
TrademarksSwiss trademark register – filing, protection, owners, Nice classes
PatentsCH patents – filing, grant, IPC classes, applicants, inventors
Patent publicationsOfficial patent publications in the Swiss Official Gazette
SPC / ESZSupplementary protection certificates for medicinal and plant-protection products

Note: Design search is not yet available in the Swissreg Datadelivery API.


Tools (11)

ToolFunction
swiss_ip_search_trademarksFree-text trademark search (wildcard * supported)
swiss_ip_get_trademarkRetrieve a trademark by registration number
swiss_ip_search_trademarks_by_ownerFind all trademarks held by a given owner
swiss_ip_search_trademarks_by_classFilter trademarks by Nice classification class
swiss_ip_search_patentsFree-text patent search
swiss_ip_get_patentRetrieve a patent by number
swiss_ip_search_patents_by_applicantFind patents by applicant or inventor name
swiss_ip_search_patent_publicationsSearch patent publications
swiss_ip_search_spcSPC/ESZ search (pharma and plant protection)
swiss_ip_search_recent_filingsFilter filings by date range across all domains
swiss_ip_get_quotaCheck remaining API data transfer quota
Resources & Prompts

Beyond tools, the server exposes two more MCP primitives:

Resources (read-only metadata, swissip:// URI scheme):

URIContent
swissip://aboutServer + data-source metadata (provenance, covered domains)
swissip://domainsList of covered IP domains

Prompts (curated workflow templates):

PromptArgumentsPurpose
trademark_availabilitynameCheck whether a name is a registered Swiss trademark
competitor_ip_reportcompanyIP overview (trademarks + patents) for a company
recent_ip_filings_reportip_type, date_from, date_toReport on recent filings in a period
Error semantics

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.


Project Phase

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.


Architecture

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 Modes
TransportUse caseConfiguration
stdioClaude Desktop, local developmentDefault (no extra setup)
Streamable HTTPCloud deployment (Render.com etc.)MCP_TRANSPORT=streamable-http
SSELegacy HTTP clients — *deprecated*MCP_TRANSPORT=sse

SSE is deprecated. Protocol revision 2026-07-28 reclassified 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:

VariableDefaultPurpose
MCP_HOST127.0.0.1Bind address. Use 0.0.0.0 only inside a container / behind a reverse proxy.
PORT / MCP_PORT8000Bind 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.


Prerequisites

  1. IGE credentials (free): Sign the terms of use and send the form by post to the IGE. Credentials are issued upon receipt.
  2. Python 3.11 or later
  3. `uv` (recommended) or pip

Installation

# Run directly with uv (recommended, no local installation needed)

uvx swiss-ip-mcp

Local development installation

git clone https://github.com/malkreide/swiss-ip-mcp cd swiss-ip-mcp pip install -e ".[dev]"


Configuration

Environment Variables
export IGE_USERNAME="your_username"

export IGE_PASSWORD="your_password"

Claude Desktop

Open the config file:

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

"mcpServers": { "swiss-ip": { "command": "uvx", "args": ["swiss-ip-mcp"], "env": { "IGE_USERNAME": "your_username", "IGE_PASSWORD": "your_password" } } } }

Other MCP Clients

swiss-ip-mcp is compatible with any MCP-capable client:

ClientConfiguration
CursorAdd to ~/.cursor/mcp.json (same format as Claude Desktop)
VS Code + ContinueAdd via continue.json MCP server block
WindsurfAdd via MCP server settings
Self-hosted (mcp-proxy)Use SSE transport with MCP_TRANSPORT=sse
Cloud / Render.com (Streamable HTTP)
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.0 only inside a container or behind a

reverse proxy. Always set MCP_ALLOWED_ORIGINS and MCP_ALLOWED_HOSTS for

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.

Docker / Kubernetes

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.


Tests

# Unit tests (no credentials needed)

PYTHONPATH=src pytest tests/ -v

Including live integration tests against the real API

IGE_USERNAME=... IGE_PASSWORD=... PYTHONPATH=src pytest tests/ -v

The CI workflow runs on Python 3.11, 3.12, and 3.13.


Observability (optional)

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

VariablePurpose
MCP_OTEL_ENABLEDSet to 1 to enable trace export (or just set the endpoint below).
OTEL_EXPORTER_OTLP_ENDPOINTOTLP/HTTP collector endpoint (standard OTEL variable).
MCP_ENVValue 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.

Logging

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"}

MCP Protocol Version

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.

EraRevisionWho reaches it
initialize handshake2024-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

Only the beginning is shown; read the rest in the repo