Skip to content
Argos Sourcing
Create account

MCP server

Plug the database into your agent

One line of configuration, and your assistant queries 18.7 million European companies: lists by country and sector, company records, and above all the filed accounts, balance sheet and income statement included. 8 tools, no account needed to try.

https://sourcing.argos-finance.fr/api/mcpStreamable HTTP transportStateless

Step 1

Add the server

In Claude Desktop, Claude Code, or any compatible client: add this entry to your MCP configuration. Nothing else is needed to start.

client configuration

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

Some clients only ask for the URL: paste it as is, the type is HTTP.

Step 2, optional

Add a key

Without a key the server answers in preview: 2 companies per call, enough to judge. A free key, no card required, raises it to 5 companies, 50 calls a day, and opens the detailed financial statements.

with an API key

{
  "mcpServers": {
    "argos-sourcing": {
      "type": "http",
      "url": "https://sourcing.argos-finance.fr/api/mcp",
      "headers": {
        "Authorization": "Bearer as_live_VOTRE_CLEF"
      }
    }
  }
}
Create a free key My keys

The 8 exposed tools

This list is the one tools/list returns: it is generated from the server itself, so it cannot fall behind.

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.

Parameters: 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.

Parameters: country, id, lang (required : 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.

Parameters: country, id, statements, max_years, lang (required : 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`.

Parameters: sectors, countries, lang (required : sectors)

list_sectorsno 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).

Parameters: countries, lang

list_countriesno 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.

Parameters: 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.

Parameters: lang

excel_export_linkno 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.

Parameters: countries, sectors, subsectors, query, sort, lang

Try without a client

The protocol is JSON-RPC over HTTP: one command is enough to check everything answers. Copy this one as is.

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" }
    }
  }'

The server answers with a readable summary in content, and the same data as JSON in structuredContent. The scope total is always exact, even when the plan shows only part of it.

What the server guarantees

The rules every answer follows

  • A scope total is always the real number of companies, even when the plan shows only part of it: an agent can cite it without reservation.
  • A value absent from the registry stays absent. No placeholder zero, no estimate, no n.d.
  • Every company carries the address of its public page and of its official registry record: the source is always citable.
  • An unknown country or sector produces an explicit error, never a result that would look like an answer.
  • A reached quota is announced as such, with the next plan and its stated cap, so the agent can explain it.
  • All tools are read-only: this server changes nothing, neither on your side nor on ours.

Frequently asked

Questions about the MCP server

Do I need an API key?

Not to try: without a key the server answers in preview, 2 companies per call, which is enough to validate the connection and the data quality. A free key, no card required, raises the preview to 5 companies per call, 50 calls a day, and opens the detailed financial statements.

Does the server keep a session?

No. It is stateless: each JSON-RPC message is an independent HTTP request, with no session id and no open stream. That is what revision 2026-07-28 of the protocol requires, and it lets calls land on any instance without sticky routing.

Which protocol revisions are served?

All four: 2026-07-28, 2025-11-25, 2025-06-18, 2025-03-26. A modern client is served without a handshake, an older one starts with initialize and gets the same tool list. Nothing to configure: the server recognises the client's era from its first request.

What does a call consume?

A tool call that queries the database counts one call against the key's daily quota. Listing the taxonomy (countries, sectors) and building an export link consume nothing. Counters come back in the X-Quota-Used and X-Quota-Limit headers, and reset every day at midnight UTC.

Can the data be redistributed?

The subscription grants internal use: building lists, feeding your tools, producing your analyses. Resale or bulk republication requires written agreement. Write to contact@argos-finance.fr describing the use, we answer within one business day.

The REST APISame data as JSON, with OpenAPI.Quotas by planFrom free to 200 calls a day.Against other databasesSourced and dated comparison.

Server argos-sourcing version 1.0.0. Protocol revisions served: 2026-07-28, 2025-11-25, 2025-06-18, 2025-03-26. A question, an unexpected behaviour: contact@argos-finance.fr