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é.
Connectez-le à votre agent
-
Claude Code
Une seule commande, sans clé pour commencer.
claude mcp add --transport http fuentio https://api.fuentio.com/mcpAvec une clé
claude mcp add --transport http fuentio https://api.fuentio.com/mcp \ --header "Authorization: Bearer YOUR_API_KEY" -
Claude Desktop et claude.ai
- Réglages → Connecteurs → Ajouter un connecteur personnalisé.
- Nom : Fuentio. URL : l’adresse ci-dessous. Puis Ajouter.
- 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 -
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" } } } } -
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}" } } } } -
ChatGPT (mode développeur)
- Paramètres → Applications et connecteurs → Paramètres avancés : activez le mode développeur.
- Créez un connecteur : nom Fuentio, URL du serveur MCP : l’adresse ci-dessous, authentification : aucune.
- 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 -
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-streamAvec 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()GratuitLes 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ésTrouvez 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ésUn 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ésEst-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.
JSONCSVExcelMarkdownHTMLXMLNDJSONParquetTSV
- 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 question | Outil |
|---|---|
| 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.