Serveur MCP

Branchez la base sur votre agent

Une ligne de configuration, et votre assistant interroge 18,7 millions de sociétés européennes : listes par pays et secteur, fiches, et surtout les comptes déposés, bilan et compte de résultat compris. 8 outils, aucun compte requis pour essayer.

https://sourcing.argos-finance.fr/api/mcpTransport Streamable HTTPSans état

Étape 1

Ajouter le serveur

Dans Claude Desktop, Claude Code, ou tout client compatible : ajoutez cette entrée à votre configuration MCP. Rien d'autre n'est nécessaire pour commencer.

configuration du client

{
  "mcpServers": {
    "argos-sourcing": {
      "type": "http",
      "url": "https://sourcing.argos-finance.fr/api/mcp"
    }
  }
}

Certains clients demandent simplement l'adresse : collez-la telle quelle, le type est HTTP.

Étape 2, facultative

Ajouter une clef

Sans clef, le serveur répond en aperçu : 2 sociétés par appel, assez pour juger. Une clef gratuite, sans carte bancaire, porte l'aperçu à 5 sociétés, 50 appels par jour, et ouvre les états financiers détaillés.

avec une clef API

{
  "mcpServers": {
    "argos-sourcing": {
      "type": "http",
      "url": "https://sourcing.argos-finance.fr/api/mcp",
      "headers": {
        "Authorization": "Bearer as_live_VOTRE_CLEF"
      }
    }
  }
}

Créer une clef gratuite Mes clefs

Les 8 outils exposés

Cette liste est celle que renvoie tools/list : elle est générée à partir du serveur lui-même, elle ne peut pas être en retard sur lui.

search_companies

Liste des societes d'un pays et d'un secteur, triees par chiffre d'affaires decroissant par defaut. Couvre 18,7 millions de societes de 25 pays europeens, issues des registres officiels (registres du commerce, comptes annuels deposes). Sert a : constituer une liste de cibles ou de comparables, chiffrer un marche, preparer une prospection, etudier un secteur dans plusieurs pays a la fois. Les secteurs sont ceux de la taxonomie Argos (84 secteurs), PAS des codes NACE : appelez list_sectors pour les libelles exacts. Les pays se donnent en ISO 3166-1 alpha-2 (FR, IT, ES, UK...). Le champ `total` renvoye est le nombre reel de societes du perimetre et doit etre cite tel quel ; `societes` n'en contient qu'une partie, bornee par l'offre de la clef utilisee.

Paramètres : countries, sectors, subsectors, query, sort, revenue_min, revenue_max, headcount_min, headcount_max, with_revenue, with_website, limit, offset, lang

get_company

Fiche complete d'une societe : denomination, forme juridique, statut au registre, adresse, activite declaree, secteur, effectif, chiffre d'affaires du dernier exercice publie, capital social, coordonnees, lien vers la fiche du registre officiel. Demande le pays (ISO 3166-1 alpha-2) et l'identifiant national obtenu par search_companies (SIREN en France, company number au Royaume-Uni, codice fiscale en Italie, etc.). Pour les comptes annuels detailles, utilisez get_financial_statements.

Paramètres : country, id, lang (obligatoires : country, id)

get_financial_statements

Comptes annuels tels que deposes au registre : bilan actif, bilan passif, compte de resultat, et selon le pays capitaux propres, flux de tresorerie et annexes. Un exercice par colonne, jusqu'a huit exercices. Les montants sont rendus en unites de devise exactes dans les donnees structurees, et mis a l'echelle (k, M, Md) dans le resume texte. C'est la difference principale avec les annuaires d'entreprises : les postes comptables reels, harmonises entre pays, pour des societes non cotees. Une ligne absente du depot reste absente : aucun poste n'est estime ni comble. Certains registres (Pologne par exemple) ne publient pas de compte de resultat. Necessite un compte : sans clef API, cet outil renvoie seulement le nombre d'exercices disponibles.

Paramètres : country, id, statements, max_years, lang (obligatoires : country, id)

list_subsectors

Sous-secteurs existant reellement dans la base pour un ou plusieurs secteurs (et eventuellement des pays), avec leurs compteurs. Sert a affiner une recherche trop large : les libelles renvoyes se passent tels quels a search_companies dans `subsectors`.

Paramètres : sectors, countries, lang (obligatoires : sectors)

list_sectorssans quota

Les 84 secteurs de la taxonomie Argos, groupes en 16 grands secteurs, identiques dans les 25 pays. Cette taxonomie remplace les codes NACE : elle est construite a partir de l'activite declaree au registre, ce qui permet de comparer un meme secteur entre pays malgre des nomenclatures nationales differentes. Donne le libelle exact a passer a search_companies, et le nombre de societes par secteur (eventuellement restreint a des pays).

Paramètres : countries, lang

list_countriessans quota

Les 25 pays europeens couverts, avec pour chacun le code ISO, le nom, le registre source, la devise et le nombre de societes en base. A appeler avant search_companies en cas de doute sur la couverture.

Paramètres : lang

database_overview

Volumetrie generale : nombre de societes, de pays et de secteurs, date de construction du millesime, repartition par pays et principaux secteurs. Utile pour repondre a "que contient cette base" et pour situer un perimetre dans l'ensemble.

Paramètres : lang

excel_export_linksans quota

Construit l'adresse de telechargement du classeur Excel d'un perimetre, sans le generer ni consommer de quota d'export. Le classeur contient la liste des societes (une ligne chacune, une trentaine de colonnes), les contacts, les repartitions par pays et par secteur, et une feuille d'etats financiers par societe (bilan actif, bilan passif, compte de resultat) pour les premieres du tri. A rendre a l'utilisateur pour qu'il l'ouvre lui-meme : le telechargement demande un compte, et c'est son quota mensuel qui est decompte.

Paramètres : countries, sectors, subsectors, query, sort, lang

Essayer sans client

Le protocole est du JSON-RPC sur HTTP : une commande suffit à vérifier que tout répond. Copiez celle-ci telle quelle.

curl

curl -s https://sourcing.argos-finance.fr/api/mcp \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -H "MCP-Protocol-Version: 2026-07-28" \
  -H "Mcp-Method: tools/call" \
  -H "Mcp-Name: search_companies" \
  -d '{
    "jsonrpc": "2.0", "id": 1, "method": "tools/call",
    "params": {
      "name": "search_companies",
      "arguments": { "countries": ["IT"], "sectors": ["Restauration"], "limit": 5 },
      "_meta": { "io.modelcontextprotocol/protocolVersion": "2026-07-28" }
    }
  }'

Le serveur répond avec un résumé lisible dans content, et les mêmes données en JSON dans structuredContent. Le total du périmètre est toujours exact, même quand l'offre n'en affiche qu'une partie.

Ce que le serveur garantit

Les règles que suivent toutes les réponses

Le total d'un périmètre est toujours le nombre réel de sociétés, même quand l'offre n'en affiche qu'une partie : un agent peut le citer sans réserve.
Une donnée absente du registre reste absente. Aucun zéro de remplacement, aucune estimation, aucun n.d.
Chaque société porte l'adresse de sa fiche publique et celle de sa fiche au registre officiel : la source est toujours citable.
Un pays ou un secteur inconnu produit une erreur explicite, jamais un résultat qui ressemblerait à une réponse.
Un quota atteint est annoncé comme tel, avec l'offre suivante et son plafond chiffré, pour que l'agent puisse l'expliquer.
Tous les outils sont en lecture seule : ce serveur ne modifie rien, ni chez vous ni chez nous.

Questions fréquentes

Questions sur le serveur MCP

Faut-il une clef API ?

Non pour essayer : sans clef, le serveur repond en apercu, 2 societes par appel, ce qui suffit a valider le branchement et la qualite des donnees. Une clef gratuite, sans carte bancaire, porte l'apercu a 5 societes par appel, 50 appels par jour, et ouvre les etats financiers detailles.

Le serveur garde-t-il une session ?

Non. Il est sans etat : chaque message JSON-RPC est une requete HTTP independante, sans identifiant de session ni flux ouvert. C'est ce que demande la revision 2026-07-28 du protocole, et cela permet de repartir les appels sur plusieurs machines sans routage collant.

Quelles revisions du protocole sont servies ?

Les quatre : 2026-07-28, 2025-11-25, 2025-06-18, 2025-03-26. Un client moderne est servi sans poignee de main, un client plus ancien commence par initialize et obtient la meme liste d'outils. Vous n'avez rien a configurer : le serveur reconnait l'epoque du client a sa premiere requete.

Que consomme un appel ?

Un appel d'outil qui interroge la base decompte un appel du quota journalier de la clef. Lister la taxonomie (pays, secteurs) et construire un lien d'export ne consomment rien. Les compteurs sont renvoyes dans les en-tetes X-Quota-Used et X-Quota-Limit, et remis a zero chaque jour a minuit UTC.

Les donnees peuvent-elles etre redistribuees ?

L'abonnement donne un droit d'usage interne : constituer des listes, alimenter vos outils, produire vos analyses. La revente ou la republication en masse demande un accord ecrit. Ecrivez a contact@argos-finance.fr en decrivant l'usage, la reponse arrive sous un jour ouvre.

L'API RESTMêmes données en JSON, avec OpenAPI.Les quotas par offreDe la gratuite à 200 appels par jour.Face aux autres basesComparaison sourcée et datée.

Serveur argos-sourcing version 1.0.0. Révisions du protocole servies : 2026-07-28, 2025-11-25, 2025-06-18, 2025-03-26. Une question, un comportement inattendu : contact@argos-finance.fr