siret-mcp

MCP-Server für Daten des französischen Unternehmensregisters. Fragen Sie nach einem beliebigen französischen Unternehmen per Name, SIREN oder SIRET und erhalten Sie sauberes JSON – mit jedem Registercode bereits in einfaches Französisch übersetzt.

Das offizielle Register liefert "nature_juridique": "5710", "activite_principale": "62.01Z", "tranche_effectif_salarie": "12". Übergibt man das einem LLM, rät es oder halluziniert. Dieser Server liefert "Société par actions simplifiée (SAS)", "Programmation informatique", "20 à 49 salariés" – mit dem ursprünglichen Code daneben, damit die Antwort überprüfbar bleibt.

Kein API-Schlüssel. Kein Konto.

Install

Claude Code

claude mcp add siret -- npx -y siret-mcp

Cursor – ~/.cursor/mcp.json:

{
  "mcpServers": {
    "siret": {
      "command": "npx",
      "args": ["-y", "siret-mcp"]
    }
  }
}

Claude Desktop – claude_desktop_config.json, derselbe Block wie bei Cursor.

Starten Sie den Client neu. Sie sollten vier Tools sehen.

Related MCP server: INSEE MCP Server

Probieren Sie diese aus

• "Ist die SIREN 552100554 noch aktiv, und welche Rechtsform hat sie?"

• "Finden Sie Softwareunternehmen in Loire-Atlantique mit mehr als 20 Beschäftigten."

• "Was bedeutet der NAF-Code 43.22A?"

• "Hier ist eine SIRET von einer Rechnung: 55210055400015 – überprüfen Sie sie und nennen Sie mir die eingetragene Anschrift."

• "Listen Sie alle Niederlassungen für diese SIREN auf und markieren Sie, welche der Hauptsitz ist."

Tools

Außerdem eine siret://health-Ressource, die Cache-Statistiken bereitstellt.

Designentscheidungen, die Sie kennen sollten

Codes werden immer mit Bezeichnungen geliefert. Jedes codierte Feld liefert {code, label, exact, source}. exact: false bedeutet, dass die Bezeichnung aus einem Fallback stammt (ein NAF-Abschnitt statt der genauen Klasse). So kann ein Modell sich angemessen absichern, statt eine Vermutung als Tatsache auszugeben.

Fehlende Felder werden benannt, nicht auf null gesetzt. Jedes Profil enthält ein missing-Array. Bei "workforce": null erfindet ein Modell oft eine Mitarbeiterzahl. Bei "missing": ["workforce"] sagt es, dass das Register sie nicht führt.

Fehler werden zurückgegeben, nicht ausgelöst. Fehler kommen als JSON mit einem hint zurück, sodass das Modell es erneut versuchen oder umformulieren kann, statt mitten im Gespräch abzubrechen.

Caching ist das Produkt, keine Optimierung. Die vorgelagerte API begrenzt Bursts. Ein Cache mit 6 Stunden TTL (SIRENE_CACHE_TTL_MS) macht das in einer Agentenschleife nutzbar, die neunmal nach demselben Unternehmen fragt.

Vier Tools, nicht zwölf. Jedes zusätzliche Tool kostet das aufrufende Modell Kontext und gibt ihm eine weitere Möglichkeit, das Falsche zu wählen.

Einschränkungen

• Codetabellen sind unvollständig. Die vollständige NAF rev. 2 umfasst ~732 Codes und die catégorie juridique ~300; dieser Server enthält die gebräuchlichen plus einen Fallback, der sich selbst als Näherung kennzeichnet (exact: false).

• Basiert auf recherche-entreprises.api.gouv.fr, nicht auf INSEE Sirene v3. Kein API-Schlüssel bedeutet, dass es sofort läuft. Der Kompromiss: weniger Felder und keine erschöpfende Auflistung der Niederlassungen.

• Der Cache ist prozessintern. Für einen lokalen stdio-Server in Ordnung, für einen gehosteten Multi-Tenant-Server die falsche Wahl.

Daten & Quellenangabe

Die Daten stammen aus der API Recherche d'Entreprises (DINUM), abgeleitet aus INSEE SIRENE, unter der Licence Ouverte. Angaben zu Geschäftsführern können ein Geburtsjahr enthalten. Sie sind dafür verantwortlich, die Daten rechtmäßig zu verwenden.

Entwicklung

git clone https://github.com/tbellicha/siret-mcp.git
cd siret-mcp
npm install
npm run build
npm test                 # node:test, offline
npm run test:live        # hits the real API
npm run typecheck

Lizenz

MIT © 2026 tbellicha