io.github.malkreide/register-mcp

Sucht Unternehmen im Schweizer Handelsregister (Zefix) nach Name, Kanton und Rechtsform. Gibt eine Liste von Firmen zurück mit Name, UID, Status, Rechtsform, Sitz und SHAB-Datum. Ideal für Lieferantenprüfungen, Vertragspartner-Screenings und Beschaffungs-Due-Diligence. Args: params (CompanySearchInput): Suchparameter: - name (Optional[str]): Firmenname (mind. 2 Zeichen) - canton (Optional[str]): Kanton (z.B. 'ZH') - legal_form_ids (Optional[list[int]]): Rechtsform-IDs - active_only (bool): Nur aktive Einträge (Standard: True) - search_type (str): CONTAINS, STARTS_WITH, EXACT, ENDS_WITH - max_results (int): 1–50 (Standard: 10) - offset (int): Paginierung (Standard: 0) - language (str): 'de', 'fr', 'it', 'en' - response_format (str): 'markdown' oder 'json' Returns: str: Gefundene Firmen mit Name, UID, Status, Rechtsform, Sitz, SHAB-Datum, Auszug-URL. Enthält Paginierungsinfo (hasMoreResults, offset, total).

Ruft vollständige Firmendetails aus dem Handelsregister ab (nach interner EHRAID). Liefert: Name, UID, Rechtsform, Sitz, Status, Zweck (Gesellschaftszweck), SHAB-Publikationshistorie (letzte 5 Einträge) und Link zum kantonalen Auszug. Die EHRAID wird aus zefix_search_companies oder zefix_get_company_by_uid zurückgegeben. Args: params (CompanyByEhraIdInput): - ehraid (int): Interne Zefix-Firmen-ID - response_format (str): 'markdown' oder 'json' Returns: str: Vollständiges Firmenprofil inkl. Zweck und SHAB-Publikationen.

Findet eine Firma im Handelsregister anhand ihrer UID (Unternehmensidentifikationsnummer). Die UID ist die eindeutige Schweizer Unternehmens-ID (CHE-xxx.xxx.xxx), identisch mit der MwSt-Nummer. Gibt vollständige Firmendetails zurück. Args: params (CompanyByUidInput): - uid (str): UID im Format CHE-xxx.xxx.xxx oder CHExxxxxxxxxxx - response_format (str): 'markdown' oder 'json' Returns: str: Vollständiges Firmenprofil (Name, Rechtsform, Status, Zweck, SHAB-Publikationen). Enthält EHRAID für Folgeabfragen mit zefix_get_company.

Schnell-Verifikation: Ist ein Unternehmen im Handelsregister eingetragen und aktiv? Gibt eine klare Ja/Nein-Antwort plus Basisdetails zurück. Ideal als erster Check vor Vertragsabschlüssen, Beschaffungen oder Subventionsvergaben. Stellt fest: - Ist die Firma im Handelsregister eingetragen? - Ist sie aktiv (EXISTIEREND) oder gelöscht? - Welche Rechtsform hat sie? - Wo ist sie domiziliert? - Gibt es mehrere ähnliche Firmen (Verwechslungsgefahr)? Args: params (VerifyCompanyInput): - name (str): Firmenname (mind. 3 Zeichen) - canton (Optional[str]): Kantonskürzel zur Eingrenzung Returns: str: Verifizierungsergebnis mit Status, Rechtsform, Sitz und Warnungen.

Listet alle im Schweizer Handelsregister verwendeten Rechtsformen auf. Nützlich zur Ermittlung der legalFormId-Werte für die Filterung in zefix_search_companies. Häufige IDs: 1=Einzelunternehmen, 2=KlG, 3=AG, 4=GmbH, 5=KmG, 6=Genossenschaft, 7=Stiftung, 8=öffentlich-rechtliche Körperschaft, 9=Verein. Args: params (LegalFormsInput): - language (str): Sprache ('de', 'fr', 'it', 'en'). Standard: 'de' - response_format (str): 'markdown' oder 'json' Returns: str: Alle Rechtsformen mit ID, Name (in gewählter Sprache) und Kurzform.

Listet Schweizer Gemeinden auf und löst die `legalSeatId` einer Firma auf. **`legalSeatId` ist eine BFS-Nummer.** Sie trifft die Spalte `BFS-ID`, nicht die interne `ID` der Gemeinde. Die beiden sind bei **keiner** der 2112 Gemeinden gleich, und beide Wertebereiche überlappen sich — wer über die falsche Spalte nachschlägt, bekommt keinen Fehler, sondern eine andere, echte Schweizer Gemeinde: `legalSeatId=261` ist Zürich, über `ID` gelesen aber Aarwangen (BE); `2701` ist Basel, über `ID` gelesen Embd (VS). Deshalb macht `legal_seat_id` die Auflösung selbst, statt sie dem Aufrufer und einer Tabelle mit zwei ähnlich aussehenden Zahlenspalten zu überlassen. Args: params (MunicipalitiesInput): - legal_seat_id (Optional[int]): `legalSeatId` einer Firma → genau eine Gemeinde. - canton (Optional[str]): Kanton-Filter (z.B. 'ZH'). Ohne Filter: alle ~2'100 Gemeinden. - response_format (str): 'markdown' oder 'json' Returns: str: Gemeindeliste mit Name, Kanton, BFS-ID und Handelsregisterkreis-ID.

Alle Amtsblatt-Publikationen (SHAB + kantonal) zu einer Firmen-UID. Das Kernfeature: der Join zwischen Handelsregister und Amtsblatt über die UID. Zefix sagt, ob eine Firma existiert — das Amtsblatt sagt, was über sie publiziert wurde (HR-Mutationen, Schuldenrufe, Konkurse, Schuldbetreibungen …). Der Einstieg ist ausschliesslich die Firmen-UID (juristische Person); ein Personen-Sucheinstieg existiert bewusst nicht (siehe README «Data Protection & Scope»). Args: params (GazettePublicationsInput): - uid (str): UID CHE-XXX.XXX.XXX (Pflicht, Regex-validiert) - rubric / sub_rubric (Optional[str]): Rubrik-/Subrubrik-Filter - date_start / date_end (Optional[str]): Zeitraum YYYY-MM-DD - limit (int): 1–100 (Standard 50) - response_format (str): 'markdown' oder 'json' Returns: str: Publikationen (neueste zuerst) mit Datum, Rubrik, Titel, ID.

Einzelne Publikation inkl. amtlichem Volltext (aus dem XML, defensiv geparst). Quirk 3: Die Listen-API liefert nur meta — der eigentliche Inhalt steht nur im rubrikspezifischen XML unter /publications/{id}/xml. Pflichtfelder: meta, publicationText. Bei HR-Rubriken zusätzlich company. Alles Übrige landet best-effort in additional_fields. Args: params (GazettePublicationInput): - id (str): Publikations-ID - response_format (str): 'markdown' oder 'json' Returns: str: Volltext + Firmenangaben (falls HR) + Zusatzfelder.

Status beider Datenquellen (Zefix + Amtsblattportal) und Cache-Alter. Prüft die Erreichbarkeit beider Upstreams und meldet das Alter der In-Memory-Caches (Rubriken, Rechtsformen). Args: params (GazetteStatusInput): - response_format (str): 'markdown' oder 'json' Returns: str: Erreichbarkeit, Latenz und Cache-Alter je Quelle.