bodacc_search
Pack: bodacc · Endpoint: https://gateway.pipeworx.io/bodacc/mcp
No MCP client? Call it directly: GET https://gateway.pipeworx.io/v1/tools/bodacc_search for the schema, then POST the same URL with its arguments for the data.
Search all BODACC notices across every French company by free text (searched across the whole notice — company name, activity, judgment/act text, addresses — not just the name), event family, département, and/or publication date range. Returns the most recently published notices first, each shaped with SIREN, company name, event family, court (greffe), location, and notice detail. Use for open-ended discovery (e.g. “insolvency notices in Lyon since August” or “business sales in Paris this month”) — use bodacc_company_events instead when you already have a SIREN or exact name. Use name instead of q when you specifically want to match the company name/denomination only.
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
q | string | no | Free-text search across the whole notice (company name, activity description, judgment/act text, address, etc). Omit to list by filters/date alone. |
name | string | no | Search the company name (commerçant/dénomination) field only, instead of the whole-notice free text of q. |
event_type | string | no | Event family — one of: ${EVENT_TYPES.join(’, ’)} (collective=insolvency, vente=sale/transfer of business, radiation=deregistration, creation=new registration, modification, dpc=account filing, conciliation, retablissement_professionnel, immatriculation, divers). English aliases also accepted: sale/transfer→vente, insolvency/bankruptcy→collective, deregistration/deletion→radiation, accounts→dpc, registration→immatriculation. |
departement | string | no | French département code to filter on, e.g. “75” (Paris), “13” (Bouches-du-Rhône), “2A”/“2B” (Corsica). |
since | string | no | Only notices published on/after this date, YYYY-MM-DD. |
until | string | no | Only notices published on/before this date, YYYY-MM-DD. |
siren | string | no | 9-digit SIREN to combine with the other filters (spaces ignored). |
limit | number,string | no | Number of notices to return (1-100). Default 20. |
offset | number,string | no | Result offset for pagination. Default 0. offset+limit is capped at 10,000 by the upstream API. |
Example call
Arguments
{
"event_type": "collective",
"departement": "75",
"since": "2026-09-20"
}
curl
curl -X POST https://gateway.pipeworx.io/bodacc/mcp \
-H 'Content-Type: application/json' \
-d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"bodacc_search","arguments":{"event_type":"collective","departement":"75","since":"2026-09-20"}}}'
TypeScript (@pipeworx/sdk)
import { Pipeworx } from '@pipeworx/sdk';
const pipeworx = new Pipeworx();
const result = await pipeworx.call('bodacc_search', {
"event_type": "collective",
"departement": "75",
"since": "2026-09-20"
});
Connect
Add this to your MCP client config, or use one-click install buttons:
{
"mcpServers": {
"bodacc": {
"url": "https://gateway.pipeworx.io/bodacc/mcp"
}
}
}
See Getting Started for client-specific install steps.