MCP Server

OpenHelvetia Gateway

swiss.openhelvetia/gateway

What this MCP does

Provides sourced access to Swiss federal legislation and political data, including law metadata, versions, amendments, citations, consultations, treaties, and in-force checks.

directory.get
The directory envelope (v0.2, authority: manifest). Real entries only — a data source enters on one of three admission routes (E21); an empty list is the honest state, never padded.
Read only
Input schema
{'type': 'object', 'properties': {}}
facts.badge
shields.io endpoint JSON for one subject, derived from the fact table — «no facts» in grey when nothing is recorded, never rounded up.
Read only
Input schema
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['domain', 'subject'], 'properties': {'domain': {'type': 'string'}, 'subject': {'type': 'string', 'description': 'Subject key (e.g. «slug#0»).'}}}
facts.latest
Latest effective facts per subject+metric from the versioned fact table — the bitemporal as_of cutoff is exposed; an absent store is the honest empty view.
Read only
Input schema
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['domain'], 'properties': {'as_of': {'type': ['string', 'null'], 'description': 'Optional bitemporal cutoff (RFC 3339).'}, 'domain': {'type': 'string', 'description': 'Measured domain («checker», «benchmark»).'}}}
fedlex.check_in_force
Check whether an act was in force on a date; false is a valid answer, never an error: use for «gilt das noch?» questions. norm.
Read only
Input schema
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['eli', 'as_of'], 'properties': {'eli': {'type': 'string'}, 'as_of': {'type': 'string', 'description': 'ISO date YYYY-MM-DD.'}}, 'additionalProperties': False}
fedlex.check_quote
Check a quote (Zitat) against the norm text of one element: use before citing, to prove the wording is in what was read (Belegkette). norm.
Read only
Input schema
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['eli_version', 'eid', 'quote'], 'properties': {'eid': {'type': 'string', 'description': 'The element that was read: an eId such as «art_6» or a path eId\nsuch as «art_6/para_1» or «annex_3/lvl_u1/lvl_2».'}, 'lang': {'type': ['string', 'null'], 'description': "Manifestation language (de|fr|it|en|rm); default de. Which\nlanguages a version carries as XML is the graph's answer â\x80\x94\nfedlex.list_expressions shows it before a read."}, 'quote': {'type': 'string', 'description': 'The wording to check, verbatim; «â\x80¦Â» or «[...]» marks an omission\n(each part must occur, in order).'}, 'eli_version': {'type': 'string', 'description': 'Dated consolidation: `<abstract-eli>/<YYYYMMDD>` â\x80\x94 the version that was read.'}}, 'additionalProperties': False}
fedlex.cite
Cite an element as its canonical Fundstelle («Art. 7 Abs. 1 Bst. b LSV») from eli_version and eId: use to label a read place in the Belegkette. norm.
Read only
Input schema
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['eli_version', 'eid'], 'properties': {'eid': {'type': 'string', 'description': 'The place to label: an eId such as «art_7/para_1/lbl_b», «art_23_a»\nor «annex_3/lvl_u1».'}, 'lang': {'type': ['string', 'null'], 'description': 'Label language (de|fr|it|en|rm) â\x80\x94 the manifestation read and the\nabbreviation used; default de.'}, 'eli_version': {'type': 'string', 'description': 'Dated consolidation: `<abstract-eli>/<YYYYMMDD>`.'}}, 'additionalProperties': False}
fedlex.compare_versions
Compare an element or every article between two Fassungen of an act — added, removed, changed paragraphs with wording: use for «was hat sich geändert?». norm.
Read only
Input schema
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['eli', 'from_version', 'to_version'], 'properties': {'eid': {'type': ['string', 'null'], 'description': 'Optional scope: one element (article or path eId); default every article.'}, 'eli': {'type': 'string', 'description': 'Fedlex ELI of the act (consolidation abstract).'}, 'lang': {'type': ['string', 'null'], 'description': "Manifestation language (de|fr|it|en|rm); default de. Which\nlanguages a version carries as XML is the graph's answer â\x80\x94\nfedlex.list_expressions shows it before a read."}, 'to_version': {'type': 'string', 'description': 'The newer consolidation: a version IRI or a date.'}, 'from_version': {'type': 'string', 'description': 'The older consolidation: a version IRI or a date (YYYY-MM-DD / YYYYMMDD).'}}, 'additionalProperties': False}
fedlex.detect_foreign_content
Detect what the text tools hide in a Fassung: sections in another language (xml:lang) and <foreign> islands (formulas, graphics): use before quoting. norm.
Read only
Input schema
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['eli_version'], 'properties': {'lang': {'type': ['string', 'null'], 'description': "Manifestation language (de|fr|it|en|rm); default de. Which\nlanguages a version carries as XML is the graph's answer â\x80\x94\nfedlex.list_expressions shows it before a read."}, 'eli_version': {'type': 'string', 'description': 'Dated consolidation: `<abstract-eli>/<YYYYMMDD>`.'}}, 'additionalProperties': False}
fedlex.explore_node
Explore a JOLux node's edges (predicates and neighbours, both directions, capped): use to debug what the graph holds about an IRI; never as proof. hint.
Read only
Input schema
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['iri'], 'properties': {'iri': {'type': 'string', 'description': 'Any Fedlex IRI (https://fedlex.data.admin.ch/â\x80¦).'}, 'limit': {'type': ['integer', 'null'], 'format': 'uint32', 'minimum': 0, 'description': 'Edges per direction (default 20, at most 50).'}}, 'additionalProperties': False}
fedlex.extract_tables
Extract the tables of a consolidation or of one element (annex limit values, tariffs) as header and rows: use when a norm is a table, not prose. norm.
Read only
Input schema
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['eli_version'], 'properties': {'eid': {'type': ['string', 'null'], 'description': 'Optional scope: an eId (an annex level such as «annex_3/lvl_u1/lvl_2», an article).'}, 'lang': {'type': ['string', 'null'], 'description': "Manifestation language (de|fr|it|en|rm); default de. Which\nlanguages a version carries as XML is the graph's answer â\x80\x94\nfedlex.list_expressions shows it before a read."}, 'eli_version': {'type': 'string', 'description': 'Dated consolidation: `<abstract-eli>/<YYYYMMDD>`.'}}, 'additionalProperties': False}
fedlex.find_related_topic
Find acts in the same field of law via the legal taxonomy, by ELI or SR: use to discover neighbouring Erlasse; candidates only. hint.
Read only
Input schema
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'properties': {'sr': {'type': ['string', 'null'], 'description': 'SR number as an alternative entry, e.g. «832.10».'}, 'eli': {'type': ['string', 'null'], 'description': 'Fedlex ELI of the act â\x80\x94 or give `sr`.'}, 'limit': {'type': ['integer', 'null'], 'format': 'uint32', 'minimum': 0, 'description': 'Max candidates (default 20, at most 50).'}}, 'additionalProperties': False}
fedlex.find_treaties
Find treaty processes (Staatsverträge) by a title word, partner country IRI or bilaterality: use to locate a treaty before get_treaty_info. hint.
Read only
Input schema
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'properties': {'limit': {'type': ['integer', 'null'], 'format': 'uint32', 'minimum': 0, 'description': 'Max hits (default 20, at most 50).'}, 'query': {'type': ['string', 'null'], 'description': 'A word of the treaty title (case-insensitive).'}, 'country': {'type': ['string', 'null'], 'description': 'Partner country as a Fedlex country vocabulary IRI.'}, 'bilateral': {'type': ['boolean', 'null'], 'description': 'true = bilateral only, false = multilateral only.'}}, 'additionalProperties': False}
fedlex.get_article_history
Trace which amendments and consolidations changed one Artikel (eId) of an act, with dates: use for «seit wann gilt Art. X so?». norm.
Read only
Input schema
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['eli', 'eid'], 'properties': {'eid': {'type': 'string', 'description': 'Akoma-Ntoso eId of the element, e.g. «art_14a» or «art_2/para_1».'}, 'eli': {'type': 'string', 'description': 'Fedlex ELI of the consolidation abstract.'}}, 'additionalProperties': False}
fedlex.get_citations
List an act's relations: cites|cited_by (formal citations, act level) or in|out (foreseen impacts, mostly consultation drafts): use to see who cites X. norm.
Read only
Input schema
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['eli', 'direction'], 'properties': {'eli': {'type': 'string'}, 'direction': {'type': 'string', 'description': '«in» | «out» (the foreseen-impact graph) or «cites» | «cited_by»\n(the formal citation graph, act level).'}}, 'additionalProperties': False}
fedlex.get_consultation_documents
List the position statements and result reports of one consultation IRI: use after get_consultations to read the genesis record. norm.
Read only
Input schema
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['consultation'], 'properties': {'consultation': {'type': 'string', 'description': 'The consultation IRI (from get_consultations).'}}, 'additionalProperties': False}
fedlex.get_consultations
List the consultations (Vernehmlassungen) of an act's drafts or of one draft, with status and dates: use for the genesis, never for law in force. hint.
Read only
Input schema
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'properties': {'eli': {'type': ['string', 'null'], 'description': 'Fedlex ELI of the act â\x80\x94 its drafts are resolved first (at most five).'}, 'draft': {'type': ['string', 'null'], 'description': 'Or a draft IRI (from get_drafts).'}, 'limit': {'type': ['integer', 'null'], 'format': 'uint32', 'minimum': 0, 'description': 'Max consultations (default 20, at most 50).'}, 'status': {'type': ['string', 'null'], 'description': 'Optional status filter: the consultation-status IRI or its last segment.'}}, 'additionalProperties': False}
fedlex.get_drafts
List the legislative drafts (Entwürfe, eli/proj) an act came from, with the Curia Vista number: use as the entry to consultations and materials. norm.
Read only
Input schema
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['eli'], 'properties': {'eli': {'type': 'string', 'description': 'Fedlex ELI of the consolidation abstract.'}}, 'additionalProperties': False}
fedlex.get_fga_documents
List the Federal Gazette (BBl) documents of an act's genesis — Botschaft, reports — with genre and date: use for materials, never for law in force. norm.
Read only
Input schema
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['eli'], 'properties': {'eli': {'type': 'string', 'description': 'Fedlex ELI of the consolidation abstract.'}}, 'additionalProperties': False}
fedlex.get_law_metadata
Read the JOLux profile of an act (titles de/fr/it, status, dates, identifier) for an ELI: use to confirm a search hit before you cite. norm.
Read only
Input schema
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['eli'], 'properties': {'eli': {'type': 'string'}, 'as_of': {'type': ['string', 'null'], 'description': 'Optional ISO date; absent = today, echoed back resolved.'}}, 'additionalProperties': False}
fedlex.get_memorial
List the AS/BBl issue (memorial) an oc publication appeared in and the acts of that issue: use after get_oc_act to locate the volume. norm.
Read only
Input schema
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['eli'], 'properties': {'eli': {'type': 'string', 'description': 'The AS publication ELI (https://fedlex.data.admin.ch/eli/oc/â\x80¦), from get_oc_act.'}, 'limit': {'type': ['integer', 'null'], 'format': 'uint32', 'minimum': 0, 'description': 'Max acts of the issue (default 20, at most 50).'}}, 'additionalProperties': False}
fedlex.get_modifications
List the amendment notes («Fassung gemäss …», AS refs) per element of a consolidation: use for «wann und wodurch wurde Art. X geändert?». norm.
Read only
Input schema
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['eli_version'], 'properties': {'eid': {'type': ['string', 'null'], 'description': 'Optional scope: only notes anchored at this eId or below.'}, 'lang': {'type': ['string', 'null'], 'description': "Manifestation language (de|fr|it|en|rm); default de. Which\nlanguages a version carries as XML is the graph's answer â\x80\x94\nfedlex.list_expressions shows it before a read."}, 'eli_version': {'type': 'string', 'description': 'Dated consolidation: `<abstract-eli>/<YYYYMMDD>`.'}}, 'additionalProperties': False}
fedlex.get_oc_act
Resolve an act's binding AS/RO publication (oc ELI, date, genre, office, memorial) from its consolidation ELI: use to cite the Amtliche Sammlung. norm.
Read only
Input schema
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['eli'], 'properties': {'eli': {'type': 'string', 'description': 'Fedlex ELI of the consolidation abstract.'}}, 'additionalProperties': False}
fedlex.get_references
List the references (Verweise) an act's text makes, with ELI where linked, optionally within one eId: use to follow cross-references. hint.
Read only
Input schema
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['eli_version'], 'properties': {'eid': {'type': ['string', 'null'], 'description': 'Optional scope: only references made from this eId or below.'}, 'lang': {'type': ['string', 'null'], 'description': "Manifestation language (de|fr|it|en|rm); default de. Which\nlanguages a version carries as XML is the graph's answer â\x80\x94\nfedlex.list_expressions shows it before a read."}, 'limit': {'type': ['integer', 'null'], 'format': 'uint32', 'minimum': 0, 'description': 'Page size (default 200, at most 1000).'}, 'offset': {'type': ['integer', 'null'], 'format': 'uint32', 'minimum': 0, 'description': 'Continuation: the `next_offset` of the previous answer.'}, 'eli_version': {'type': 'string', 'description': 'Dated consolidation: `<abstract-eli>/<YYYYMMDD>`.'}}, 'additionalProperties': False}
fedlex.get_structure
Outline one consolidation (sections, articles with eId, num and heading): use when you know the act but not the article number. norm.
Read only
Input schema
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['eli_version'], 'properties': {'lang': {'type': ['string', 'null'], 'description': "Manifestation language (de|fr|it|en|rm); default de. Which\nlanguages a version carries as XML is the graph's answer â\x80\x94\nfedlex.list_expressions shows it before a read."}, 'depth': {'type': ['string', 'null'], 'description': '«article» (default: the skeleton down to articles) or «full»\n(the whole tree down to paragraphs and items).'}, 'eli_version': {'type': 'string', 'description': 'Dated consolidation: `<abstract-eli>/<YYYYMMDD>`.'}}, 'additionalProperties': False}
fedlex.get_subdivisions
List the subdivisions JOLux knows for an act (amended elements only, a gap catalogue): use to see which Artikel carry amendments; outline: get_structure. norm.
Read only
Input schema
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['eli'], 'properties': {'eli': {'type': 'string', 'description': 'Fedlex ELI of the consolidation abstract.'}}, 'additionalProperties': False}
fedlex.get_taxonomy
Classify an act in the systematic collection (SR branch chain, notation, labels de/fr/it): use for «zu welchem Rechtsgebiet gehört X?». norm.
Read only
Input schema
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['eli'], 'properties': {'eli': {'type': 'string', 'description': 'Fedlex ELI of the consolidation abstract.'}}, 'additionalProperties': False}
fedlex.get_treaty_info
Read a treaty process profile (title, signature, bilateral, partner countries, approving decree) for an eli/treaty IRI: use after find_treaties. norm.
Read only
Input schema
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['eli'], 'properties': {'eli': {'type': 'string', 'description': 'The treaty process IRI (https://fedlex.data.admin.ch/eli/treaty/â\x80¦), from find_treaties.'}, 'lang': {'type': ['string', 'null'], 'description': 'Preferred title language (de|fr|it|en|rm); default de.'}}, 'additionalProperties': False}
fedlex.list_annexes
List the annexes (Anhänge) of a consolidation with titles and path eIds (annex_u1/…): use before reading an Anhang with read_article. norm.
Read only
Input schema
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['eli_version'], 'properties': {'lang': {'type': ['string', 'null'], 'description': "Manifestation language (de|fr|it|en|rm); default de. Which\nlanguages a version carries as XML is the graph's answer â\x80\x94\nfedlex.list_expressions shows it before a read."}, 'eli_version': {'type': 'string', 'description': 'Dated consolidation: `<abstract-eli>/<YYYYMMDD>`.'}}, 'additionalProperties': False}
fedlex.list_expressions
List the language versions and manifestations (XML, PDF) of one consolidation: use before reading to see whether a Fassung is PDF-only. norm.
Read only
Input schema
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['eli_version'], 'properties': {'eli_version': {'type': 'string', 'description': 'Dated consolidation: `<abstract-eli>/<YYYYMMDD>`.'}}, 'additionalProperties': False}
fedlex.list_versions
List every dated consolidation (Fassung) of an act, future ones included: use to pick the eli_version the reading tools need. norm.
Read only
Input schema
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['eli'], 'properties': {'eli': {'type': 'string', 'description': 'Fedlex ELI of the consolidation abstract.'}}, 'additionalProperties': False}
fedlex.parse_reference
Parse a citation («Art. 7 Abs. 1 lit. b LSV») into act, article eId and path proposal: use to turn a quoted Fundstelle into what read_article can open. hint.
Read only
Input schema
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['text'], 'properties': {'text': {'type': 'string', 'description': 'A citation in plain text, e.g. «Art. 7 Abs. 1 lit. b LSV», «Anhang 3\nZiff. 2 LSV», «Art. 8 EMRK i.V.m. Art. 36 BV», «SR 832.10».'}}, 'additionalProperties': False}
fedlex.read_article
Read one element (Artikel, Absatz, Anhang) of a dated consolidation by eId, e.g. art_6 or annex_u1/lvl_u1: use to quote a norm. norm.
Read only
Input schema
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['eli_version', 'eid'], 'properties': {'eid': {'type': 'string', 'description': 'Akoma-Ntoso eId, e.g. «art_10a», or a path eId such as\n«art_2/para_1» or «annex_u1/lvl_u1».'}, 'lang': {'type': ['string', 'null'], 'description': "Manifestation language (de|fr|it|en|rm); default de. Which\nlanguages a version carries as XML is the graph's answer â\x80\x94\nfedlex.list_expressions shows it before a read."}, 'eli_version': {'type': 'string', 'description': 'Dated consolidation: `<abstract-eli>/<YYYYMMDD>`.'}}, 'additionalProperties': False}
fedlex.read_document
Read a whole small act or Verordnung as capped Markdown (truncated flag, continuation offset): use for short acts; quote via read_article. norm.
Read only
Input schema
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['eli_version'], 'properties': {'lang': {'type': ['string', 'null'], 'description': "Manifestation language (de|fr|it|en|rm); default de. Which\nlanguages a version carries as XML is the graph's answer â\x80\x94\nfedlex.list_expressions shows it before a read."}, 'offset': {'type': ['integer', 'null'], 'format': 'uint32', 'minimum': 0, 'description': 'Continuation: the `next_offset` of the previous answer.'}, 'max_chars': {'type': ['integer', 'null'], 'format': 'uint32', 'minimum': 0, 'description': 'Character budget (default 120 000, at most 400 000).'}, 'eli_version': {'type': 'string', 'description': 'Dated consolidation: `<abstract-eli>/<YYYYMMDD>`.'}}, 'additionalProperties': False}
fedlex.resolve_consolidation_at
Resolve which consolidation (Fassung) of an act governed on an ISO date: use before reading text for a past or future Stichtag. norm.
Read only
Input schema
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['eli', 'as_of'], 'properties': {'eli': {'type': 'string'}, 'as_of': {'type': 'string', 'description': 'ISO date YYYY-MM-DD.'}}, 'additionalProperties': False}
fedlex.resolve_sr
Resolve an SR number (e.g. 832.10) to the act's ELI, titles and in-force status: use when a question names an SR; predecessors stay visible. norm.
Read only
Input schema
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['sr'], 'properties': {'sr': {'type': 'string', 'description': 'Systematic (SR) number, e.g. «832.10».'}}, 'additionalProperties': False}
fedlex.resolve_vocabulary_label
Look up a Fedlex vocabulary term (enforcement-status, language, …) by label or IRI: use to decode a coded value from another answer. hint.
Read only
Input schema
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['vocabulary', 'query'], 'properties': {'lang': {'type': ['string', 'null'], 'description': 'Label language (de|fr|it|en|rm); default de.'}, 'query': {'type': 'string', 'description': 'A label fragment (case-insensitive, any language) or a\nvocabulary IRI to decode.'}, 'vocabulary': {'type': 'string', 'description': 'Scheme id: «enforcement-status», «subdivision-type»,\n«legal-taxonomy», «impact-type», «resource-type», «language», â\x80¦'}}, 'additionalProperties': False}
fedlex.search_law
Search acts by title keyword or official abbreviation (KVG, StPO, OR): use when you know the name but not the SR or ELI; in-force acts rank first. hint.
Read only
Input schema
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['query'], 'properties': {'limit': {'type': ['integer', 'null'], 'format': 'uint32', 'minimum': 0}, 'query': {'type': 'string'}}, 'additionalProperties': False}
fedlex.search_text
Find where a word occurs inside ONE consolidation (hits with eId and Artikel): use before read_article when the article is unknown. hint.
Read only
Input schema
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['eli_version', 'query'], 'properties': {'lang': {'type': ['string', 'null'], 'description': "Manifestation language (de|fr|it|en|rm); default de. Which\nlanguages a version carries as XML is the graph's answer â\x80\x94\nfedlex.list_expressions shows it before a read."}, 'limit': {'type': ['integer', 'null'], 'format': 'uint32', 'minimum': 0, 'description': 'Max hits (default 20, at most 100); `total` counts beyond it.'}, 'query': {'type': 'string', 'description': 'Word or phrase; case-insensitive substring.'}, 'eli_version': {'type': 'string', 'description': 'Dated consolidation: `<abstract-eli>/<YYYYMMDD>`.'}}, 'additionalProperties': False}
i14y.api_status
Check whether the I14Y catalogue answers, register by register, so «no data» and «source down» stay apart: use before retrying a failed call. norm.
Read only
Input schema
{'type': 'object', 'properties': {}}
i14y.get_concept
Show one concept's record — type, value type, version, validity (Konzept, Codeliste): use before reading a code list's entries. norm.
Read only
Input schema
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['concept_id'], 'properties': {'lang': {'type': ['string', 'null']}, 'concept_id': {'type': 'string', 'description': "The concept's `id` from `i14y.list_concepts`."}}, 'additionalProperties': False}
i14y.get_data_service
Show one registered interface's record — endpoints, OpenAPI links, licence, served datasets (API, Endpunkt): use to reach the service. norm.
Read only
Input schema
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['data_service_id'], 'properties': {'lang': {'type': ['string', 'null']}, 'data_service_id': {'type': 'string', 'description': "The service's `id` from `i14y.list_data_services`."}}, 'additionalProperties': False}
i14y.get_dataset
Show one dataset's full record — contact, coverage, every distribution with its licence and download address (Lizenz, Download): use before reuse. norm.
Read only
Input schema
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['dataset_id'], 'properties': {'lang': {'type': ['string', 'null']}, 'dataset_id': {'type': 'string', 'description': "The record's `id` as a hit or a list row carries it â\x80\x94 a GUID,\nnever the publisher's `identifier`."}}, 'additionalProperties': False}
i14y.get_dataset_distributions
List a dataset's distributions — format, licence, download and access address (Datei, Lizenz, Format): use for «where do I get the data». norm.
Read only
Input schema
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['dataset_id'], 'properties': {'lang': {'type': ['string', 'null']}, 'dataset_id': {'type': 'string', 'description': "The record's `id` as a hit or a list row carries it â\x80\x94 a GUID,\nnever the publisher's `identifier`."}}, 'additionalProperties': False}
i14y.list_catalogs
List the catalogues that feed I14Y, each one body's collection (Katalog, opendata.swiss, Bundesamt): use to see who contributes. norm.
Read only
Input schema
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'properties': {'lang': {'type': ['string', 'null']}, 'page': {'type': ['integer', 'null'], 'format': 'uint32', 'minimum': 0}, 'limit': {'type': ['integer', 'null'], 'format': 'uint32', 'minimum': 0, 'description': 'Catalogues per page, 1â\x80\x93100, default 50.'}}, 'additionalProperties': False}
i14y.list_concepts
List the harmonised concepts and code lists of the administration (Konzept, Codeliste, Nomenklatur, Merkmal): use to find a code list by publisher. norm.
Read only
Input schema
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'properties': {'lang': {'type': ['string', 'null']}, 'page': {'type': ['integer', 'null'], 'format': 'uint32', 'minimum': 0}, 'limit': {'type': ['integer', 'null'], 'format': 'uint32', 'minimum': 0}, 'publisher': {'type': ['string', 'null']}, 'registration_status': {'type': ['string', 'null']}}, 'additionalProperties': False}
i14y.list_data_services
List the registered machine interfaces of Swiss public bodies with their endpoints (API, Schnittstelle, Datendienst): use before building a scraper. norm.
Read only
Input schema
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'properties': {'lang': {'type': ['string', 'null']}, 'page': {'type': ['integer', 'null'], 'format': 'uint32', 'minimum': 0}, 'limit': {'type': ['integer', 'null'], 'format': 'uint32', 'minimum': 0}, 'publisher': {'type': ['string', 'null']}, 'access_rights': {'type': ['string', 'null']}, 'registration_status': {'type': ['string', 'null']}}, 'additionalProperties': False}
i14y.list_datasets
List the registered datasets, paged, with publisher, themes and access right (Datensätze, Metadaten, Open Data): use for a census or a publisher's list. norm.
Read only
Input schema
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'properties': {'lang': {'type': ['string', 'null'], 'description': 'Label language (de|fr|it|en|rm); default de.'}, 'page': {'type': ['integer', 'null'], 'format': 'uint32', 'minimum': 0, 'description': '1-based page, default 1.'}, 'limit': {'type': ['integer', 'null'], 'format': 'uint32', 'minimum': 0, 'description': 'Records per page, 1â\x80\x93100, default 25.'}, 'publisher': {'type': ['string', 'null'], 'description': 'Publisher code («CH_BAZG»), from `i14y.list_publishers`.'}, 'access_rights': {'type': ['string', 'null'], 'description': 'PUBLIC | RESTRICTED | NON_PUBLIC | CONFIDENTIAL. A listing is\nmetadata, never a grant of access.'}, 'registration_status': {'type': ['string', 'null'], 'description': 'One of the eight: Incomplete, Candidate, Recorded, Qualified,\nStandard, PreferredStandard, Superseded, Retired.'}}, 'additionalProperties': False}
i14y.list_public_services
List the registered public services with their channels (Behördenleistung, Dienstleistung, Verwaltung): use for what an authority offers citizens. norm.
Read only
Input schema
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'properties': {'lang': {'type': ['string', 'null']}, 'page': {'type': ['integer', 'null'], 'format': 'uint32', 'minimum': 0}, 'limit': {'type': ['integer', 'null'], 'format': 'uint32', 'minimum': 0}, 'publisher': {'type': ['string', 'null']}, 'registration_status': {'type': ['string', 'null']}}, 'additionalProperties': False}
i14y.list_publishers
List the bodies that publish into I14Y with identifier and Swiss UID (Herausgeber, Bundesamt, Kanton, UID): use to find a publisher's code for a filter. norm.
Read only
Input schema
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'properties': {'uid': {'type': ['string', 'null'], 'description': 'Exact Swiss UID as the register writes it («CHE116244755»).'}, 'lang': {'type': ['string', 'null']}, 'page': {'type': ['integer', 'null'], 'format': 'uint32', 'minimum': 0}, 'limit': {'type': ['integer', 'null'], 'format': 'uint32', 'minimum': 0, 'description': 'Publishers per page, 1â\x80\x93100, default 50.'}, 'identifier': {'type': ['string', 'null'], 'description': 'Exact publisher code («CH_BAZG»).'}}, 'additionalProperties': False}
i14y.search_catalog
Search the national data catalogue I14Y by words (Datensatz, Schnittstelle, API, Behördenleistung, Codeliste): use first, to find who publishes what. hint.
Read only
Input schema
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['query'], 'properties': {'lang': {'type': ['string', 'null'], 'description': 'The language searched AND served (de|fr|it|en|rm); default de.'}, 'page': {'type': ['integer', 'null'], 'format': 'uint32', 'minimum': 0, 'description': '1-based page, default 1.'}, 'limit': {'type': ['integer', 'null'], 'format': 'uint32', 'minimum': 0, 'description': 'Hits per page, 1â\x80\x93100, default 25.'}, 'query': {'type': 'string', 'description': 'Free text, e.g. «Sonderpädagogik», «Zoll», «API»; empty lists\nthe whole index one page at a time. Matched in `lang`.'}, 'types': {'type': ['array', 'null'], 'items': {'type': 'string'}, 'description': 'Restrict to resource types: Dataset | DataService |\nPublicService | Concept | MappingTable. Each of them answers.'}, 'themes': {'type': ['array', 'null'], 'items': {'type': 'string'}, 'description': 'Theme CODES as a hit carries them under `themes[].code`\n(«103» is Bildung) â\x80\x94 never a word.'}, 'publishers': {'type': ['array', 'null'], 'items': {'type': 'string'}, 'description': 'Publisher CODES â\x80\x94 the `identifier` `i14y.list_publishers`\nserves («CH1» is the Federal Statistical Office) â\x80\x94 never a name.'}}, 'additionalProperties': False}
i14y.search_codelist_entries
List the codes of one code-list concept, paged, with names and validity (Code, Codeliste, Kanton, Geschlecht, Nomenklatur): use to resolve official codes. norm.
Read only
Input schema
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['concept_id'], 'properties': {'lang': {'type': ['string', 'null'], 'description': 'The language matched and served (de|fr|it|en|rm); default de.'}, 'page': {'type': ['integer', 'null'], 'format': 'uint32', 'minimum': 0}, 'limit': {'type': ['integer', 'null'], 'format': 'uint32', 'minimum': 0, 'description': 'Entries per page, 1â\x80\x93200, default 50.'}, 'query': {'type': ['string', 'null'], 'description': "A word of an entry's name, `*` for any characters; absent =\nevery entry. Matched in `lang` only."}, 'concept_id': {'type': 'string', 'description': 'The `id` of a concept whose `concept_type` is CodeList.'}}, 'additionalProperties': False}
lindas.describe
Show everything the holding says about one IRI (a cube, an observation, a Kanton): use to follow an address you were handed. norm.
Read only
Input schema
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['iri'], 'properties': {'iri': {'type': 'string', 'description': 'Any IRI â\x80\x94 the store is asked about it; no host is fetched.'}, 'lang': {'type': ['string', 'null']}, 'limit': {'type': ['integer', 'null'], 'format': 'uint32', 'minimum': 0}, 'offset': {'type': ['integer', 'null'], 'format': 'uint32', 'minimum': 0}}, 'additionalProperties': False}
lindas.describe_cube
Show a cube's declared dimensions and profile — the record may carry more: use to learn the filters a question needs. hint.
Read only
Input schema
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['cube'], 'properties': {'cube': {'type': 'string', 'description': 'A cube IRI of the served scope, e.g.\n`https://politics.ld.admin.ch/political-rights/popular-vote/1`.'}, 'lang': {'type': ['string', 'null']}, 'limit': {'type': ['integer', 'null'], 'format': 'uint32', 'minimum': 0}, 'offset': {'type': ['integer', 'null'], 'format': 'uint32', 'minimum': 0}}, 'additionalProperties': False}
lindas.dimension_values
List the values one dimension takes (Kantone, Abstimmungstypen, Geschäftsstände): use to filter by IRI instead of by text. hint.
Read only
Input schema
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['cube', 'dimension'], 'properties': {'cube': {'type': 'string'}, 'lang': {'type': ['string', 'null']}, 'limit': {'type': ['integer', 'null'], 'format': 'uint32', 'minimum': 0}, 'dimension': {'type': 'string', 'description': 'The dimension IRI as `lindas.describe_cube` served it â\x80\x94 never\nbuilt by appending to the cube IRI.'}}, 'additionalProperties': False}
lindas.find_cube
Find the cube behind a question by a word of its name («Volksinitiative», «Petition», «Parteienregister»): use before reading rows. hint.
Read only
Input schema
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['query'], 'properties': {'lang': {'type': ['string', 'null']}, 'limit': {'type': ['integer', 'null'], 'format': 'uint32', 'minimum': 0}, 'query': {'type': 'string', 'description': "A word of the cube's name, 2â\x80\x93100 characters\n(«Abstimmung», «Interessenbindung»)."}}, 'additionalProperties': False}
lindas.list_cubes
List the 44 political data cubes of the Confederation (Abstimmungen, Wahlen, Bundesrat, Interessenbindungen): use to see what data exists. norm.
Read only
Input schema
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'properties': {'lang': {'type': ['string', 'null'], 'description': 'Label language (de|fr|it|en|rm); default de. The answer names\nthe language it served, and «und» where a name carries no tag.'}, 'limit': {'type': ['integer', 'null'], 'format': 'uint32', 'minimum': 0}, 'family': {'type': ['string', 'null'], 'description': 'One of `fc`, `fch/apg`, `national-council-election`,\n`political-rights`; absent = all 44.'}, 'offset': {'type': ['integer', 'null'], 'format': 'uint32', 'minimum': 0}}, 'additionalProperties': False}
lindas.list_versions
List the versions of a cube family (Nationalratswahl 2019/2023/2027): use before reading a year; nothing links old to new. norm.
Read only
Input schema
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['cube'], 'properties': {'cube': {'type': 'string', 'description': 'Any version of the family, e.g.\n`â\x80¦/national-council-election/candidates/2019`.'}}, 'additionalProperties': False}
lindas.observations
Read a cube's rows with filters (Abstimmung, Referendum, Volksinitiative, Ständemehr, Kanton, Datum): use for the figures themselves. norm.
Read only
Input schema
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['cube'], 'properties': {'cube': {'type': 'string'}, 'lang': {'type': ['string', 'null']}, 'limit': {'type': ['integer', 'null'], 'format': 'uint32', 'minimum': 0}, 'offset': {'type': ['integer', 'null'], 'format': 'uint32', 'minimum': 0}, 'filters': {'type': ['array', 'null'], 'items': {'anyOf': [{'type': 'object', 'required': ['dimension', 'value'], 'properties': {'value': {'type': 'string', 'description': 'An IRI (matched exactly) or a plain literal.'}, 'dimension': {'type': 'string', 'description': 'The dimension IRI as `lindas.describe_cube` served it.'}}, 'description': '`{dimension, value}` â\x80\x94 the canonical form.', 'additionalProperties': False}, {'type': 'string', 'description': '`dimension=value` â\x80\x94 the FIRST `=` separates them.'}], 'description': 'One filter: the object `{dimension, value}`, or the string\n`dimension=value`.'}, 'description': 'Filters, one per entry: the object `{dimension, value}` â\x80\x94\n`{"dimension": "https://politics.ld.admin.ch/political-rights/popular-vote/date",\n"value": "1971-02-07"}` â\x80\x94 or, equally accepted, the string\n`dimension=value`. The dimension is the full IRI\n`lindas.describe_cube` served, the value an IRI or a plain\nliteral. A dimension the shape does not declare is admitted\nwhen the cube\'s observations carry it, and the answer says so.'}, 'dimensions': {'type': ['array', 'null'], 'items': {'type': 'string'}, 'description': 'The dimension IRIs to project â\x80\x94 the cells a row comes back\nwith. Absent = every cell the row carries, which is up to 51 in\nthe vote cube; naming the three or four a question needs is one\ncall instead of paging the same table at a smaller limit.'}}, 'additionalProperties': False}
lindas.resolve_label
Resolve an IRI to its label in one language with a fallback (Kanton, Partei, Gremium, Interessenbindung): use to name a value. hint.
Read only
Input schema
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['iri'], 'properties': {'iri': {'type': 'string', 'description': 'Any IRI, of any host (canton, country, legal form, gender).'}, 'lang': {'type': ['string', 'null']}}, 'additionalProperties': False}
manifest.get
One entry's manifest by slug. A slug the directory does not hold is a not-found error carrying the E21 admission rule.
Read only
Input schema
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['slug'], 'properties': {'slug': {'type': 'string', 'description': 'Entry slug (filename = @id slug, oh-validate-enforced).'}}}
meta.capabilities
The platform capability register with published per-client coverage — tool names on this server ARE the capability ids.
Read only
Input schema
{'type': 'object', 'properties': {}}
meta.schemas
Stage two of two-stage discovery: the full input schemas of the named tools, byte-identical to what tools/list carries, because both are read from the same router. An unknown id is refused by name rather than silently dropped.
Read only
Input schema
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['names'], 'properties': {'names': {'type': 'array', 'items': {'type': 'string'}, 'description': 'The capability ids whose input schemas are wanted, as stage one\nlisted them.'}}}
meta.tools
Stage one of two-stage discovery: every mounted tool with its capability id, domain, one-line summary and budget weight — and NO input schemas. Ask this first to learn what exists, then pull the schemas of the few tools you intend to call (meta.schemas). Context economy as a capability, not a client convention (E16 Ziff. 1).
Read only
Input schema
{'type': 'object', 'properties': {}}
publish.info
The publishing path — the only way into the directory: the three E21/E13 routes plus the honest interim state.
Read only
Input schema
{'type': 'object', 'properties': {}}
standard.artifacts
The manifest standard's sealed artifact register: path, canonical IRI, draft/published status and SHA-256 per contract file.
Read only
Input schema
{'type': 'object', 'properties': {}}
Changed
manifest.get
Sept. 27, 2026, 2:50 a.m.
Changed
lindas.observations
Sept. 27, 2026, 2:50 a.m.
Changed
lindas.describe_cube
Sept. 27, 2026, 2:50 a.m.
Added
standard.artifacts
Sept. 17, 2026, 12:55 p.m.
Added
publish.info
Sept. 17, 2026, 12:55 p.m.
Added
meta.tools
Sept. 17, 2026, 12:55 p.m.
Added
meta.schemas
Sept. 17, 2026, 12:55 p.m.
Added
meta.capabilities
Sept. 17, 2026, 12:55 p.m.
Added
manifest.get
Sept. 17, 2026, 12:55 p.m.
Added
lindas.resolve_label
Sept. 17, 2026, 12:55 p.m.
Added
lindas.observations
Sept. 17, 2026, 12:55 p.m.
Added
lindas.list_versions
Sept. 17, 2026, 12:55 p.m.
Added
lindas.list_cubes
Sept. 17, 2026, 12:55 p.m.
Added
lindas.find_cube
Sept. 17, 2026, 12:55 p.m.
Added
lindas.dimension_values
Sept. 17, 2026, 12:55 p.m.
Added
lindas.describe_cube
Sept. 17, 2026, 12:55 p.m.
Added
lindas.describe
Sept. 17, 2026, 12:55 p.m.
Added
i14y.search_codelist_entries
Sept. 17, 2026, 12:55 p.m.
Added
i14y.search_catalog
Sept. 17, 2026, 12:55 p.m.
Added
i14y.list_publishers
Sept. 17, 2026, 12:55 p.m.
Added
i14y.list_public_services
Sept. 17, 2026, 12:55 p.m.
Added
i14y.list_datasets
Sept. 17, 2026, 12:55 p.m.
Added
i14y.list_data_services
Sept. 17, 2026, 12:55 p.m.
Added
i14y.list_concepts
Sept. 17, 2026, 12:55 p.m.
Added
i14y.list_catalogs
Sept. 17, 2026, 12:55 p.m.
Added
i14y.get_dataset_distributions
Sept. 17, 2026, 12:55 p.m.
Added
i14y.get_dataset
Sept. 17, 2026, 12:55 p.m.
Added
i14y.get_data_service
Sept. 17, 2026, 12:55 p.m.
Added
i14y.get_concept
Sept. 17, 2026, 12:55 p.m.
Added
i14y.api_status
Sept. 17, 2026, 12:55 p.m.