get_enterprise
Pack: entreprises-fr · Endpoint: https://gateway.pipeworx.io/entreprises-fr/mcp
Fetch a single legal unit with all its establishments by SIREN (9 digits).
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
siren | string | yes | 9-digit SIREN identifier |
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":"get_enterprise","arguments":{}}}'Response shape
| Field | Type | Description |
|---|---|---|
results | array | Array with single legal unit (or empty if not found) |
total_results | number | Total number of matching results (0 or 1) |
page | number | Current page (always 1) |
per_page | number | Results per page (always 1) |
Full JSON Schema
{
"type": "object",
"properties": {
"results": {
"type": "array",
"description": "Array with single legal unit (or empty if not found)",
"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": "All 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 (0 or 1)"
},
"page": {
"type": "number",
"description": "Current page (always 1)"
},
"per_page": {
"type": "number",
"description": "Results per page (always 1)"
}
}
}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.