Pour les agents IA

Des registres officiels que votre agent peut utiliser, et citer.

Fuentio fait tourner un serveur MCP : Claude, Cursor et tout client MCP peuvent vérifier une entreprise dans son registre officiel en pleine tâche. Chaque réponse commence par une phrase simple et se termine par sa source.

Conçu pour les agents IA : un serveur MCP et une API REST, avec des limites dites franchement : ce qui n’est pas couvert est annoncé, jamais deviné.

Chaque pays, couvert ou non →

Connectez-le à votre agent

  1. Claude Code

    Une seule commande, sans clé pour commencer.

    claude mcp add --transport http fuentio https://api.fuentio.com/mcp

    Avec une clé

    claude mcp add --transport http fuentio https://api.fuentio.com/mcp \
      --header "Authorization: Bearer YOUR_API_KEY"
  2. Claude Desktop et claude.ai

    1. Réglages → Connecteurs → Ajouter un connecteur personnalisé.
    2. Nom : Fuentio. URL : l’adresse ci-dessous. Puis Ajouter.
    3. Dans une conversation, activez Fuentio dans le menu des outils et demandez par exemple « Le SIREN 441639465 est-il toujours actif ? »

    Les connecteurs personnalisés ne peuvent pas envoyer de clé : ils utilisent l’essai sans clé.

    https://api.fuentio.com/mcp
  3. Cursor

    Dans ~/.cursor/mcp.json, ou .cursor/mcp.json dans un projet.

    {
      "mcpServers": {
        "fuentio": {
          "url": "https://api.fuentio.com/mcp"
        }
      }
    }

    Avec une clé

    {
      "mcpServers": {
        "fuentio": {
          "url": "https://api.fuentio.com/mcp",
          "headers": {
            "Authorization": "Bearer YOUR_API_KEY"
          }
        }
      }
    }
  4. VS Code (mode agent de GitHub Copilot)

    Dans .vscode/mcp.json. Avec une clé, VS Code la demande une fois et la garde en lieu sûr.

    {
      "servers": {
        "fuentio": {
          "type": "http",
          "url": "https://api.fuentio.com/mcp"
        }
      }
    }

    Avec une clé

    {
      "inputs": [
        {
          "type": "promptString",
          "id": "fuentio-key",
          "description": "Fuentio API key",
          "password": true
        }
      ],
      "servers": {
        "fuentio": {
          "type": "http",
          "url": "https://api.fuentio.com/mcp",
          "headers": {
            "Authorization": "Bearer ${input:fuentio-key}"
          }
        }
      }
    }
  5. ChatGPT (mode développeur)

    1. Paramètres → Applications et connecteurs → Paramètres avancés : activez le mode développeur.
    2. Créez un connecteur : nom Fuentio, URL du serveur MCP : l’adresse ci-dessous, authentification : aucune.
    3. Dans une conversation, choisissez le connecteur dans le menu des outils et posez votre question.

    Les noms des menus changent souvent ; l’aide de ChatGPT donne le chemin à jour. Les connecteurs ChatGPT utilisent l’essai sans clé.

    https://api.fuentio.com/mcp
  6. Tout client HTTP streamable

    Sans état, réponses en JSON. Pas besoin de clé pour commencer.

    POST https://api.fuentio.com/mcp
    Accept: application/json, text/event-stream

    Avec une clé

    POST https://api.fuentio.com/mcp
    Accept: application/json, text/event-stream
    Authorization: Bearer YOUR_API_KEY

Les outils En service

  • list_coverage()Gratuit

    Les pays et les formats d’identifiant couverts, et la fraîcheur des données. À appeler d’abord en cas de doute.

  • lookup_company(country, identifier, id_scheme?, format?)1 unité

    Vérifiez une entreprise avant de l’intégrer, de la payer ou de la contacter. France : SIREN, SIRET ou numéro de TVA. Espagne : feuille du Registro Mercantil.

  • search_companies(country, query, postal_code?, locality?, status?, page?, format?)2 unités

    Trouvez une entreprise par son nom quand vous ne connaissez pas son numéro.

  • get_company_history(country, identifier, page?)1 unité

    Voyez ce qui a changé dans une entreprise (statut, adresse, nom, forme juridique) et quand, avec la source officielle de chaque changement. Pour l’Espagne, les actes du BORME arrivent aussi comme événements datés.

  • verify_company(country, identifier, id_scheme?, reference?)5 unités

    Un contrôle KYB pour l’onboarding, ou avant de payer ou de signer : un résultat (verified, partial ou unverified), les raisons et un code de preuve. Utilisez lookup_company pour une lecture rapide, et search_companies d’abord si vous n’avez qu’un nom.

  • resolve_company(country, name?, identifier?, postal_code?, locality?)2 unités

    Est-ce la même entreprise ? Rapprochez une fiche client ou fournisseur (un identifiant officiel, ou un nom avec un code postal ou une commune) des registres officiels : des candidates, chacune avec une décision et ses raisons. Seul un identifiant officiel fait le lien ; un nom n’est jamais une preuve.

  • explain_match(left, right)1 unité

    Pourquoi deux fiches de registre sont, ou ne sont pas, la même entreprise : la décision, les codes de raison et les éléments de preuve.

  • watch_company(entity_id, callback_url)1 unité

    Surveillez une entreprise : quand ses fiches officielles changent, Fuentio envoie les changements, signés, à votre adresse https. Clé API requise.

Formats d’export

lookup_company et search_companies, ainsi que la recherche par numéro et par nom en REST, acceptent un paramètre format facultatif. Mêmes unités, sauf pour un fichier de recherche de plus de 25 lignes : 2 unités par tranche de 25 lignes entamée.

  • JSON
  • CSV
  • Excel
  • Markdown
  • HTML
  • XML
  • NDJSON
  • Parquet
  • TSV
  • Au plus 100 lignes par réponse.
  • Excel et Parquet arrivent sous forme de lien de téléchargement valable 24 heures.
  • Chaque ligne garde sa source et sa date de vérification.

Une recherche en CSV

curl "https://api.fuentio.com/v1/companies/search?country=FR&q=renault&format=csv"

Quel outil, quand

Votre questionOutil
Vous n’avez que le nom de l’entreprise.search_companies
Vous avez un SIREN, un SIRET, un numéro de TVA ou une feuille du registre espagnol.lookup_company
Vous intégrez une entreprise et avez besoin d’un contrôle KYB.verify_company
Vous voulez savoir ce qui a changé, et quand.get_company_history
Vous avez une fiche client ou fournisseur et voulez savoir à quelle entreprise immatriculée elle correspond.resolve_company
Vous voulez être prévenu quand une entreprise change.watch_company
Vous ne savez pas ce qui est couvert.list_coverage

Ce que voit votre agent

Une fiche réelle de notre instantané, telle que l’outil de recherche la renvoie (les réponses de l’outil sont en anglais) :

L’appel de l’outil

lookup_company({"country": "FR", "identifier": "441639465"})

La première ligne que lit votre agent

RENAULT (FR, SIREN 441639465) is active as of 2025-12-06, source: Annuaire des Entreprises (API Recherche d'entreprises).

Puis la fiche complète en JSON, avec sa source, sa licence et l’heure de vérification.

Vous préférez le REST ?

Les mêmes données en HTTPS. Essayez sans clé, puis créez une clé gratuite en un appel.

Un essai gratuit sans clé (20 unités par jour), et des clés gratuites avec 100 unités par mois.

Chercher une entreprise, sans clé

curl https://api.fuentio.com/v1/companies/FR/441639465

Créer une clé gratuite

curl -X POST https://api.fuentio.com/v1/keys

Des erreurs sur lesquelles un agent peut agir

invalid_identifier
Le numéro n’a pas le bon format ou la bonne clé.
not_found
Un numéro bien formé, sans fiche publique.
id_scheme_not_supported
Un type d’identifiant connu que nous ne consultons pas, comme un NIF espagnol : cherchez par nom.
quota_exceeded
Unités épuisées ; le message indique comment continuer.
upstream_unavailable
La source officielle ne répond pas ; réessayez dans une minute.