FR Company Intelligence (MCP)

What does FR Company Intelligence do?

Pass a French company name, SIREN (9 digits) or SIRET (14 digits) and get back a single structured JSON object with the company's identity, dirigeants, NAF activity, address, latest revenue and net income, and a flag for any active collective procedure. Designed to be called from an MCP agent loop (Claude, Cursor, GPT…) - input minimal, output small, run completes in seconds.

Default data source: the official recherche-entreprises.api.gouv.fr which already aggregates INSEE Sirene + INPI dirigeants + DGFiP finances. No API key required for the baseline.

Why use it from an AI agent?

• Sub-second runs - agents can chain 50 calls in a sales-research loop.
• Idempotent - same input → same output, no race conditions.
• Tight schema - agents don't waste tokens parsing tables.
• Free baseline + paid upgrade - the gov.fr tier covers identity + finances; opt in to Pappers for BODACC procedures and INPI marques.

Input

Field	Type	Default	Description
query	string	-	Required. Company name, SIREN, SIRET, or domain (doctolib.fr works)
includeFinancials	boolean	true	Include chiffreAffaires, resultatNet, full finances array
includeBodacc	boolean	false	BODACC publications. Requires pappersApiToken (BYOK) or env var
includeMarques	boolean	false	INPI trademarks. Requires pappersApiToken (BYOK) or env var
pappersApiToken	string	-	Bring your own Pappers API token (free 100/month at pappers.fr/api). Unlocks direct SIREN/SIRET lookup, BODACC, INPI marques. You pay your own quota - no shared key.

{
    "query": "Doctolib",
    "includeFinancials": true
}

Output

Single object, written to both the run's dataset (1 row) and the default key-value store under the key OUTPUT:

{
    "siren": "794598813",
    "siret": "79459881300077",
    "nom": "DOCTOLIB",
    "raisonSociale": "DOCTOLIB",
    "sigle": null,
    "formeJuridique": "SAS",
    "formeJuridiqueCode": "5710",
    "dateCreation": "2013-09-23",
    "statut": "active",
    "codeNaf": "62.01Z",
    "adresse": "54 QUAI CHARLES PASQUA 92300 LEVALLOIS-PERRET",
    "codePostal": "92300",
    "commune": "LEVALLOIS-PERRET",
    "dirigeants": [
        {
            "nom": "NIOX-CHATEAU",
            "prenom": "Stanislas",
            "role": "Président de SAS",
            "type": "personne physique",
            "nationalite": null
        }
    ],
    "dirigeantsCount": 1,
    "trancheEffectif": "42",
    "categorieEntreprise": "ETI",
    "chiffreAffaires": 311448000,
    "resultatNet": -127499000,
    "finances": [
        { "annee": 2024, "chiffreAffaires": 311448000, "resultatNet": -127499000 },
        { "annee": 2023, "chiffreAffaires": 230000000, "resultatNet": -200000000 }
    ],
    "nombreEtablissements": 9,
    "nombreEtablissementsOuverts": 3,
    "procedureCollective": null,
    "bodacc": [],
    "marques": [],
    "sources": ["recherche-entreprises.api.gouv.fr"],
    "pappersUrl": "https://www.pappers.fr/entreprise/794598813",
    "govUrl": "https://annuaire-entreprises.data.gouv.fr/entreprise/794598813",
    "scrapedAt": "2026-05-08T12:00:00.000Z"
}

Pricing (PPE)

Mode	Price per call
Default (gov.fr only, w/ finances)	$0.006
pappersApiToken set (BYOK)	$0.006
includeBodacc and/or includeMarques	$0.006 (you also burn 1 token from your Pappers quota)

Pricing is per-call, billed via Apify Pay-Per-Event (apify-actor-start + apify-default-dataset-item). You bring your own Pappers token when you need the Pappers-only fields, so this Actor never burns a shared quota.

Compare: Pappers direct API costs ~$0.10/call ($99/mo for 1000 calls). This Actor adds disambiguation, MCP-friendly schema, and the free gov.fr baseline at a fraction of that price.

Calling from an MCP agent

The Apify MCP server (mcp.apify.com) exposes this Actor as the tool call-actor with name fr-company-intelligence-mcp. A typical agent prompt: "Use call-actor to look up Doctolib via the fr-company-intelligence-mcp Actor and return its latest revenue." The agent receives the JSON above and can answer in a single turn.

Sources, freshness, legality

• recherche-entreprises.api.gouv.fr - official French government service, public open data, no auth, ≈7 req/s rate limit. Refresh cadence: daily for INSEE, weekly for finances.
• api.pappers.fr (optional) - commercial API, your account, your quota. Pappers has explicit ToS for programmatic access; respect their fair-use.

This Actor exposes only public regulatory / commercial-register data. No personal data beyond what is already published in the Sirene / INPI public registers.