OneMCP

Serveur MCP unifié pour les données business publiques France & Europe. Un seul connecteur, des dizaines de sources officielles, agrégation gratuite (sources sans auth) ou avec vos clés. onemcp.fr

v0.5.0 — 41 tools, 16 sources

Pourquoi

Les agents IA ont besoin de données business françaises fiables. Aujourd'hui :

• Pappers, SocieteInfo, Infonet sont payants et juste des wrappers de l'open data public.
• Les APIs officielles (INSEE, INPI, BODACC, BAN, etc.) sont gratuites mais éclatées, formats hétérogènes, OAuth différents.

Ce serveur agrège tout ça en un seul connecteur MCP avec un schéma canonique unique.

Quick Start

1. npx (le plus simple)

npx -y @altura_ma/onemcp

2. Claude Desktop / Claude Code

{
  "mcpServers": {
    "business-fr": {
      "command": "npx",
      "args": ["-y", "@altura_ma/onemcp"]
    }
  }
}

Fichiers de config :

• macOS : ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows : %APPDATA%\Claude\claude_desktop_config.json
• Claude Code : claude mcp add business-fr -- npx -y @altura_ma/onemcp

3. API hébergée (Streamable HTTP)

{
  "mcpServers": {
    "business-fr": {
      "url": "https://api.onemcp.fr/mcp",
      "headers": {
        "Authorization": "Bearer mk_live_xxx"
      }
    }
  }
}

Endpoints publics

• https://api.onemcp.fr/openapi.json — spec REST complète
• https://api.onemcp.fr/openapi-gpt.json — spec compacte Custom GPT
• https://api.onemcp.fr/status.json — statut machine-readable
• https://api.onemcp.fr/status/checks — checks détaillés
• https://api.onemcp.fr/api/user/keys — gestion des clés du tenant (auth clé)
• https://api.onemcp.fr/api/keys — admin keys

Gestion des clés API

• Dashboard utilisateur : https://onemcp.fr/dashboard
• Console admin : https://onemcp.fr/keys
• Guide repo : docs/api-keys.md

Vous pouvez maintenant :

• créer des clés nommées
• régénérer, désactiver, réactiver, supprimer une clé
• définir un quota mensuel par clé, en plus du quota global du tenant

Tools par groupe

| Groupe | Tools | Description | |---|---|---| | Méta | mcp_guide, sources_list | Routing + liste des sources | | Entreprise | company_search, company_get, company_enrich, company_batch, company_deep_profile | Recherche, fiche, enrichissement, batch, profil complet | | Layer 2 (BYOK) | company_sirene, company_rne, company_uk | INSEE, INPI RNE, UK Companies House | | Légal | legal_announcements_search, legal_procedures_check | BODACC, procédures collectives | | Textes légaux (BYOK) | law_search, jurisprudence_search, code_table_of_contents | Légifrance, jurisprudence | | Géo | address_search, address_reverse, address_risks | BAN, Géorisques | | Géo admin | admin_commune_search, admin_commune_get, admin_departement_list, admin_departement_communes, admin_region_list, admin_epci_list, admin_epci_communes | Communes, départements, régions, EPCIs | | Immobilier | realestate_transactions | DVF — transactions par commune/code postal | | Identité | vat_validate, lei_lookup, lei_search | VIES, GLEIF | | Brevets | patents_search, patent_get | EPO Open Patent Services | | Emploi (BYOK) | jobs_search, rome_search | France Travail | | Marchés publics | public_contracts_search | DECP — données essentielles contrats publics | | Intelligence zone | area_business_intelligence | Analyse business d'une zone géographique |

Total : 41 tools

BYOK (Bring Your Own Keys)

Certains connecteurs nécessitent des credentials. Configurez-les en variables d'environnement :

| Connecteur | Variables | Docs | |---|---|---| | INSEE Sirene | INSEE_CLIENT_ID, INSEE_CLIENT_SECRET | api.insee.fr | | INPI RNE | INPI_USERNAME, INPI_PASSWORD | data.inpi.fr | | UK Companies House | COMPANIES_HOUSE_API_KEY | developer.company-information.service.gov.uk | | Légifrance (PISTE) | PISTE_CLIENT_ID, PISTE_CLIENT_SECRET | piste.gouv.fr | | France Travail | FRANCE_TRAVAIL_CLIENT_ID, FRANCE_TRAVAIL_CLIENT_SECRET | francetravail.io | | EPO Patents | EPO_OPS_KEY, EPO_OPS_SECRET | ops.epo.org |

Vérifiez votre configuration :

npm run check-env

Développement

git clone <repo-url>
cd onemcp
npm install
npm run check-env  # vérifier les credentials optionnels
npm run build
npm test

# Local dev avec stdio
npm run dev

# HTTP mode (Streamable HTTP)
PORT=3000 npm run start:http

# Inspector officiel pour tester les tools
npm run inspector

# Smoke test tous les connecteurs
./scripts/smoke-test.sh

Schéma canonique

Toutes les réponses retournent un format normalisé avec champ provenance :

{
  siren: "552032534",
  legal_name: "ANTHROPIC",
  active: true,
  headquarter: { siret, address: { ... } },
  officers: [...],
  financials: [...],
  provenance: [
    {
      source: "recherche-entreprises",
      source_url: "...",
      fetched_at: "2026-05-06T22:00:00Z",
      license: "Licence Ouverte 2.0 (Etalab)"
    }
  ],
  _raw: { ... }  // données brutes de la source
}

Sources couvertes (16 sources)

| Source | Type | Auth | Licence | |---|---|---|---| | Recherche d'entreprises (DINUM) | SIREN/SIRET, dirigeants, finances | Non | Licence Ouverte 2.0 | | BODACC | Annonces légales, procédures collectives | Non | Licence Ouverte 2.0 | | BAN | Géocodage adresses françaises | Non | LO 2.0 / ODbL | | Géorisques | Risques naturels/technologiques | Non | Licence Ouverte 2.0 | | DVF | Transactions immobilières (5 ans) | Non | Licence Ouverte 2.0 | | VIES (UE) | Validation TVA intracommunautaire | Non | Données publiques EU | | GLEIF | Identifiants LEI mondiaux | Non | CC0 1.0 | | Geo-France (IGN) | Communes, départements, régions | Non | Licence Ouverte 2.0 | | DECP | Marchés publics, contrats | Non | Licence Ouverte 2.0 | | EPO OPS | Brevets européens | BYOK | EPO OPS Terms | | INSEE Sirene | Registre officiel entreprises | BYOK | Licence Ouverte 2.0 | | INPI RNE | Registre national entreprises + UBO | BYOK | Licence Ouverte 2.0 | | Légifrance (PISTE) | Codes, lois, jurisprudence | BYOK | LO 2.0 | | France Travail | Offres d'emploi, codes ROME | BYOK | France Travail CGU | | UK Companies House | Entreprises britanniques | BYOK | OGL v3 | | GLEIF LEI | Identifiants LEI + relations groupe | Non | CC0 1.0 |

Conformité

• RGPD : ce serveur n'expose que des données publiques. Les données personnelles (dirigeants) sont systématiquement minimisées (date de naissance tronquée à YYYY-MM). Documenter votre base légale (intérêt légitime) et l'origine des données auprès des personnes concernées (RGPD Art. 14).
• Licences sources : préservées dans chaque réponse (champ provenance.license). Mention obligatoire dans toute réutilisation.

Architecture

Voir docs/architecture.md.

Licence

MIT.