Search French companies by name
search_french_companiesSearch French companies by name or SIREN in the official INSEE Sirene / INPI RNE registry. Returns top 10 matches with confidence scores and homonym hints to pick the right company.
Instructions
Use FIRST whenever a French company is mentioned by NAME without an identifier. French company search and company lookup by name or SIREN in the official French company registry (INSEE Sirene / INPI RNE data). Returns the top 10 matches, each with a score_confiance (0-1 match confidence) and a correspondance_nom, which together help pick among homonyms; total_results counts every match (tronque: true beyond the 10 served, note_troncature when it is a lower bound). Order: match level first, served as correspondance_nom (exacte: the name, the official name in the French search, equals q once the legal forms written for the result's country are removed at either end of both, never the last word, for the countries of the closed list of written legal forms, a GLEIF result from any other country keeping its whole name; mots_entiers: every remaining word of q is a word of the name; ressemblance: the rest, an acronym or other-field hit included; null if q is a SIREN, SIRET or the result's national ID, or no name is served), then an internal ranking score, not score_confiance (European search: score_confiance before its cap at 1 and its rounding; French search: the similarity of the name, usual name and acronym, plus 0.05 for an active company, the name and acronym only in the real-time fallback); ties: by SIREN in the French search, one country in turn in the European search (rank by national ID within each country, then country code). etages_abandonnes is always present: an empty array means the top 10 is complete; a non-empty one (with resultats_partiels: true) means the local index was degraded and the real-time fallback failed, so the list is partial: retry in a few seconds. If aucune_correspondance_fiable is true, no result resembles the name you asked for (best confidence < 0.5): do NOT treat the top hit as the company; check the spelling or retry. In the local index, typo tolerance only covers active companies under full disclosure: a ceased company, or one under partial disclosure, is found there by its exact name, its beginning or all its words. Partial diffusion (rule diffusion_partielle_nom_retenu_et_compte): a name search leaves out a unit not proven to be a legal person, uncounted (total_results lowered); a SIREN or SIRET search serves it with denomination null, counted in ecartes.diffusion_partielle. Paid via x402 ($0.002 in USDC or EURC). When you report a result, cite its citation verbatim.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"q": "<q>"
},
"name": "search_french_companies"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| q | Yes | Company name, or a French identifier (SIREN, SIRET, VAT number); spaced or labelled ("SIREN : 552 032 534") is fine, it resolves directly. Unsupported characters are stripped, not rejected. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| hint | No | How to settle the quote, present when payment_required is true. | |
| quote | No | The signable x402 payment requirements when payment_required is true: {x402Version, accepts[]} where each entry carries scheme, network, amount, asset and payTo (USDC and EURC options at the same numeric amount). Sign one entry and call again with `x_payment`. | |
| resultat | No | The endpoint's JSON response when payment_required is false. Paid responses carry `source`, `disclaimer` and an Ed25519 signature, and every paid JSON response carries a `provenance` array (all tools since 2026-09-06): one entry per block served, with the official register, licence, version, `empreinte_sha256` (full snapshots), `as_of` date and `precision_as_of` (what that date means), plus the common per-block envelope: `etat` in a closed list (servi, absence_mesuree, absence_non_conclusive, partiel, perime, indisponible, sans_objet), `motif` when unavailable, `age_jours` (only for publication or ingestion dates), `couverture` (complete / partielle / non_mesurable with its measure) and `confiance` in bands (faible / moyenne / forte, only where a measure grounds it, never averaged across blocks). Read the states before the numbers: an absence_non_conclusive, indisponible or partiel block is never « nothing to report »; only absence_mesuree asserts an absence. Register codes: GET /v1/provenance/registres ; states, closed lists and reading rules: GET /v1/lecture (both free). The PDF tools carry no JSON envelope (the PDF report prints it). | |
| free_tier | No | Free API key offer for this tool, present with a quote. | |
| payment_required | Yes | True when this response is an x402 payment quote instead of data: settle one of the quote's `accepts` options and call the tool again with `x_payment`. |