I14y MCP logo

I14y MCP

Read-only MCP access to Switzerland’s I14Y metadata catalogue, datasets, APIs, services, concepts, publishers, and licences.

Install I14y MCP

Pick your client, then add it in one click or paste the config.

STDIOPython
~/Library/Application Support/Claude/claude_desktop_config.json
claude_desktop_config.json
{
  "mcpServers": {
    "i14y-mcp": {
      "command": "uvx",
      "args": [
        "i14y-mcp"
      ]
    }
  }
}

Settings → Developer → Edit Config, merge this into mcpServers, then fully quit and reopen Claude Desktop.

Install not yet sandbox-tested— we haven't run this command through our automated sandbox yet. Not a red flag; we're working through the catalog.

Overview

The i14y-mcp MCP server connects AI agents to Switzerland’s I14Y national metadata catalogue over a live, unauthenticated HTTPS API. It provides read-only tools for finding datasets, retrieving distributions and licences, inspecting registered APIs, and querying concepts, publishers, catalogues, and public services. Use it when an agent needs to identify who publishes data, where it is available, or which usage terms apply before working with Swiss public data. The server supports stdio and streamable HTTP transports.

Use cases

  • Search Swiss catalogue metadata by topic
  • Check dataset download URLs and licences
  • Identify publishers and their Swiss UID
  • Inspect registered Swiss API endpoints
  • Look up harmonised concepts and code-list entries

Key features

  • Free-text catalogue search
  • Paginated dataset and catalogue listings
  • Dataset distributions, formats, and licence retrieval
  • Registered API and public-service discovery
  • Concept and code-list lookup
  • Read-only live API access with retries

Tools13

What I14y MCP lets your agent do. Expand a tool for its parameters.

Self-reported~176 tokens of context

Security & health

What it can reach and how reliably it runs — from our own checks, not the maintainer’s claims.

ActiveLast checked 3d ago

Recent health check succeeded.

6/6 checks healthy over the last 40d

Supply-chain signal

No high-severity advisories surfaced by our automated scan.

Critical 0High 0Medium 0Low 0

Scanned 13d ago via OSV.dev · i14y-mcp (PyPI)

Adoption & maintenance

Factual signals from GitHub, npm, and our automated checks — not a rating.

Last commit27d agoMost recent push to the default branch.
Tools exposed13Callable tools this server registers over MCP.

How I14y MCP works

What i14y-mcp MCP server does

i14y-mcp MCP server exposes Switzerland’s I14Y interoperability platform through MCP tools. I14Y is the national metadata catalogue maintained by the Federal Statistical Office and describes datasets, registered data services, public services, harmonised concepts, code lists, publishers, and contributing catalogues. The catalogue follows the DCAT-AP-CH profile, also identified as eCH-0200.

The server is designed for discovery before data use. An agent can search for a topic, identify the publishing body, inspect a dataset’s metadata, find download locations, and check the associated licence. Dataset records can also include a contact point. All exposed operations are read-only and idempotent; upstream write operations are not made available.

How it works

i14y-mcp MCP server uses the live I14Y API at api.i14y.admin.ch/api rather than maintaining a local catalogue copy. Requests use HTTPS without authentication. The server supports both stdio and streamable HTTP transports, allowing an MCP host to connect through the default local process or an HTTP endpoint.

The client layer retries transient failures with backoff intervals of two, four, and eight seconds, while four-hundred-level responses are not retried. search_catalog applies a client-side result limit because the upstream search endpoint does not honour paging. list_datasets provides the paginated dataset register and is the option to use when complete register traversal is required instead of free-text discovery. api_status returns an evaluable reachability result, including when the upstream service is unavailable.

The server exposes MCP tools only. It does not provide MCP Resources or Prompts. Tool responses are mapped from DCAT records into a flatter, single-language representation and include source and provenance information according to the project architecture.

Setup and configuration

The project requires Python 3.10 or newer. The default stdio launch is available through uvx i14y-mcp, as described by the project documentation. No API credential is required because the server reads public I14Y endpoints without authentication.

Connections can use stdio or streamable HTTP. The server supports the MCP protocol revisions negotiated by current clients and also documents a modern 2026-07-28 request envelope. Client support for a particular protocol revision may determine which connection mode and features are available.

Tools and capabilities

i14y-mcp MCP server includes the following read-only tools:

  • search_catalog searches catalogue content by free text.
  • list_datasets enumerates the paginated dataset register.
  • get_dataset retrieves a complete dataset metadata record.
  • get_dataset_distributions returns download URLs, formats, and licences.
  • list_data_services and get_data_service inspect registered Swiss APIs and their records.
  • list_public_services lists administrative services for citizens.
  • list_concepts and get_concept access harmonised concepts and code lists.
  • search_codelist_entries searches individual entries in a code list.
  • list_publishers returns publishing bodies and Swiss UID values.
  • list_catalogs lists contributing catalogues.
  • api_status checks API reachability with graceful degradation.

Reach for search_catalog first when the topic or dataset name is known only as natural language. Follow it with get_dataset, distribution retrieval, or service lookup when the agent needs actionable access details or licensing information.

Limitations and notes

The server is read-only and does not expose I14Y write operations. It does not provide personal data, authentication flows, MCP Resources, or MCP Prompts. Results depend on the live upstream API, so temporary service failures can affect catalogue queries even though transient requests are retried. The project is private and is not affiliated with, endorsed by, or operated on behalf of an employer or public authority.

Reviews

No reviews yet — be the first to share how it worked for you.

Frequently Asked Questions about I14y MCP

i14y-mcp is an MCP server that connects AI agents to Switzerland’s I14Y national metadata catalogue through its public HTTPS API. Its main tools search and list datasets, retrieve metadata, distributions, download URLs and licences, inspect registered data services, and query concepts, code lists, publishers, catalogues, and public services.

Run it through `uvx i14y-mcp` for the default stdio transport.

Yes, it supports standard MCP connections through stdio or streamable HTTP, so it can be used with MCP clients that support those transports.

Yes, `get_dataset_distributions` returns distribution download URLs, formats, and licences. `get_dataset` also retrieves the full metadata record for a dataset, including aggregated distribution and contact information where present.

No, every exposed tool is read-only and idempotent. The upstream API may contain write operations, but this server deliberately does not expose them.

Related MCP servers

Add a badge to your READMEShow it’s listed — live SVG, Markdown or HTML.

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:
Live Dynamic SVG PreviewI14y MCP AllMCPs Directory Badge
Markdown (GitHub README)
[![AllMCPs](https://allmcps.com/api/badge/i14y-mcp?style=directory)](https://allmcps.com/mcp/i14y-mcp)
HTML Embed
<a href="https://allmcps.com/mcp/i14y-mcp"><img src="https://allmcps.com/api/badge/i14y-mcp?style=directory" alt="I14y MCP on AllMCPs" /></a>