search
Pack: entreprises-fr · Endpoint: https://gateway.pipeworx.io/entreprises-fr/mcp
Full-text search across French legal units. Matches name, sigle, director names, addresses. Returns SIREN, denomination, establishments, sector code (APE/NAF), and basic financials.
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
query | string | yes | Free-text — name / director / address |
postal_code | string | no | Filter to a 5-digit French postal code |
departement | string | no | Filter to a French département (e.g. “75” Paris, “13” Bouches-du-Rhône) |
ape | string | no | APE/NAF activity code (e.g. “6201Z” software dev) |
employee_range | string | no | Employee count band: NN | 00 | 01 | 02 | 03 | 11 | 12 | 21 | 22 | 31 | 32 | 41 | 42 | 51 | 52 | 53 (Sirene tranche codes) |
only_active | boolean | no | Restrict to currently active units (default true) |
per_page | number | no | Page size, 1-25 (default 10) |
page | number | no | 1-based page (default 1) |
Example call
curl -X POST https://gateway.pipeworx.io/entreprises-fr/mcp \
-H 'Content-Type: application/json' \
-d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"search","arguments":{}}}'Response shape
| Field | Type | Description |
|---|---|---|
results | array | Array of matching legal units |
total_results | number | Total number of matching results |
page | number | Current page number |
per_page | number | Results per page |
Full JSON Schema
{
"type": "object",
"properties": {
"results": {
"type": "array",
"description": "Array of matching legal units",
"items": {
"type": "object",
"properties": {
"siren": {
"type": "string",
"description": "9-digit SIREN identifier"
},
"denomination": {
"type": "string",
"description": "Legal unit name"
},
"sigle": {
"type": "string",
"description": "Abbreviated name or acronym"
},
"ape": {
"type": "string",
"description": "APE/NAF activity code"
},
"address": {
"type": "string",
"description": "Registered address"
},
"postal_code": {
"type": "string",
"description": "5-digit postal code"
},
"city": {
"type": "string",
"description": "City name"
},
"departement": {
"type": "string",
"description": "French département code"
},
"etat_administratif": {
"type": "string",
"description": "Administrative status (A=active, R=radiated)"
},
"tranche_effectif_salarie": {
"type": "string",
"description": "Employee count band"
},
"etablissements": {
"type": "array",
"description": "Registered establishments",
"items": {
"type": "object",
"properties": {
"siret": {
"type": "string",
"description": "14-digit SIRET identifier"
},
"enseigne": {
"type": "string",
"description": "Trading name"
},
"address": {
"type": "string",
"description": "Establishment address"
},
"postal_code": {
"type": "string",
"description": "5-digit postal code"
},
"city": {
"type": "string",
"description": "City name"
},
"etat_administratif": {
"type": "string",
"description": "Status (A=active, R=closed)"
}
}
}
},
"dirigeants": {
"type": "array",
"description": "Directors and managers",
"items": {
"type": "object",
"properties": {
"nom": {
"type": "string",
"description": "Director name"
},
"prenom": {
"type": "string",
"description": "Director first name"
},
"fonction": {
"type": "string",
"description": "Role/title"
}
}
}
},
"labels": {
"type": "array",
"description": "RGE eco-labels or certifications",
"items": {
"type": "string"
}
}
}
}
},
"total_results": {
"type": "number",
"description": "Total number of matching results"
},
"page": {
"type": "number",
"description": "Current page number"
},
"per_page": {
"type": "number",
"description": "Results per page"
}
}
}Connect
Add this to your MCP client config, or use one-click install buttons:
{
"mcpServers": {
"entreprises-fr": {
"url": "https://gateway.pipeworx.io/entreprises-fr/mcp"
}
}
}See Getting Started for client-specific install steps.