fr.legalonePublished by legalone.frOfficial publisherv0.1.1Updated Nov 3, 2026
French company data from public registers (Sirene, RNE, BODACC) and French legal notices.
LegalOne Entreprises's hosted MCP server (mcp.legalone.fr), published by legalone.fr; no sign-in required; Streamable HTTP; 11 tools.
No AI overview yet: these facts come from the registry entry and the server itself.
Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.
Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.
Read https://sourceweft.com/mcp/fr.legalone%2Fentreprises/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.Add this to your client's mcpServers config.
{
"mcpServers": {
"legalone-entreprises": {
"type": "http",
"url": "https://mcp.legalone.fr/mcp"
}
}
}A free, read-only REST API and a keyless MCP server for public data on French companies, plus helper tools for French legal notices (annonces légales).
The MCP server is listed as LegalOne Entreprises (a different, unrelated product is named "LegalOne" in the MCP registry).
This repository holds the public client material only: an agent skill, two single-file SDKs (TypeScript, Python) and the MCP registry manifest.
Tools: search_companies, get_company, get_establishment, list_bodacc_notices, get_bodacc_notice, list_company_documents, search_addresses, get_legal_notice_price, which_legal_notice, get_next_steps, prepare_legal_notice. All are read-only except prepare_legal_notice, which saves a draft on legalone.fr. Nothing is paid in the chat.
Claude (claude.ai and Claude Desktop): Settings > Connectors > Add custom connector, name LegalOne Entreprises, URL https://mcp.legalone.fr/mcp, no authentication. Connectors added on claude.ai are also available in Claude Desktop.
Claude Code:
ChatGPT: Settings > Apps & Connectors > Advanced settings, turn on developer mode, then create a connector with the URL https://mcp.legalone.fr/mcp and no authentication. Availability depends on your ChatGPT plan; menu names may change.
Other clients that accept a remote server:
Clients that only speak stdio can go through a bridge such as npx -y mcp-remote https://mcp.legalone.fr/mcp.
Keep the key server-side; never ship it in client code.
Every response is { data, meta, links }; meta carries updatedAt, sources, warnings and attribution. Errors use RFC 9457 (application/problem+json): 400 bad parameter, 401 missing or invalid key, 404 unknown or not publicly available (treat as "not found", do not retry), 429 quota exceeded (wait for Retry-After), 503 retry later. The full list of routes is in the OpenAPI contract and in SKILL.md.
Each SDK is one file with no dependency: copy it into your project.
Methods: getCompany / get_company, getEstablishment, searchCompanies, listBodaccNotices, getBodaccNotice, listCompanyDocuments, health. Errors raise LegalOneError (status, title, detail, request id, retry delay on 429). Code comments and error messages are in French.
Python tests (local loopback server, no network): cd sdk/python && python3 -m unittest -v.
SKILL.md tells an agent when and how to use the API or the MCP server. Claude Code: copy it to .claude/skills/legalone/SKILL.md. Other agents: point them to https://api.legalone.fr/skill.md.
Each response lists the sources actually used, with their update date, in meta.sources.
Display meta.attribution next to the data, as is. For company data it reads:
Données : LegalOne — sources INSEE Sirene, INPI RNE, DILA BODACC, mise à jour le {date}
{date} is meta.updatedAt as DD/MM/YYYY; "LegalOne" links to the company page (data.links.legalone) or to https://legalone.fr. Address routes read Adresses : Base Adresse Nationale (BAN), Licence Ouverte 2.0 — via LegalOne. Do not present the data as certified by INPI or INSEE.
The code and documentation in this repository are under the MIT licence. Data returned by the API remains under the source licences above and the LegalOne terms of use.
Source: README.md at commit 9be6b69
Search French companies
Use this when the user names a French company (or gives a SIREN or SIRET) and you need to identify it: returns up to 20 matches with name, SIREN, status, legal form code, NAF code and head-office city. Name matching is a prefix match on the official name. Do not use for people, officers or shareholders, and do not use it to list companies by sector or area.
pagelimitqueryrequiredGet a French company's profile
Use this when you know a company's SIREN and the user wants its identity, or wants to pre-fill a business customer's onboarding form: name, active or ceased, legal form code, NAF code, creation date, head office, establishments, share capital and current officers (name and role only), with sources and update date. Do not use for financial statements, beneficial owners, contact details or people searches, or as a regulatory identity check (KYC); that data is not provided.
sirenrequiredGet a French establishment by SIRET
Use this when the user gives a SIRET (14 digits) and wants that establishment's address, activity code, status and whether it is the head office. Do not use to find all establishments of a company; get_company lists them.
siretrequiredList a company's BODACC notices
Use this when the user asks what was officially published about a company (registration, changes, sale of business, insolvency proceedings, removal) and you know its SIREN: returns the latest BODACC notices, newest first, with links to the official text. Do not use to search notices by person, court decision type or region.
limitsirenrequiredRead one BODACC notice
Use this when you have a BODACC notice identifier (for example from list_bodacc_notices) and need its detailed content. Personal details such as birth dates and home addresses are never included. Do not use to look for notices without an identifier.
idrequiredList a company's filed documents
Use this when the user wants to know which deeds or annual-accounts filings a company has registered (title and dates), with a link to download them from the INPI. Do not use to read financial figures; the documents themselves are not returned.
sirenrequiredNormalize a French postal address
Use this when the user gives a French postal address, complete or partial, and wants it checked, completed, normalized or geolocated: returns the best Base Adresse Nationale matches with house number, street, postcode, city, INSEE municipality code, coordinates and a match score, plus whether the best match is reliable. Do not use for addresses outside France, for finding who lives or works at an address, or for listing the companies at an address.
limitaddressrequiredpostcodeGet the regulated price of a French legal notice
Use this when the user asks how much a legal notice (annonce légale) costs for a formality in a French department: returns the exact regulated price excluding and including VAT, set by ministerial order and identical in every authorised newspaper of that department. Notices priced by the character need their text for an exact amount; without it the rate per character is returned. Do not use to compare newspapers or providers: the price is set by law and is the same everywhere.
textformalityrequireddepartmentrequiredFind which French legal notices a company must publish
Use this when a French company or its adviser describes a corporate event (creation, registered office transfer within or outside the department, change of manager or president, name, corporate purpose, share capital, legal form, duration, dissolution, liquidation closure, sale of a business…) and needs to know which legal notices are mandatory, how many, in which department, on what legal basis and at what price. The answer comes from a fixed table of rules; when it needs one more fact, it returns a question instead of a guess. Do not use for court-ordered insolvency notices or for legal advice on whether to take the decision.
legalFormdepartmentsituationsrequirednewLegalFormnewDepartmentsameCommercialCourtsoleShareholderIsCompanyNext steps after a French legal notice
Use this when the user has published, or is about to publish, a legal notice and asks what comes next: the filing on the one-stop shop for business formalities (guichet unique, INPI), deadlines, what the court registry does (BODACC) and the documents to prepare for that formality. Do not use as a substitute for the official checklist shown by the one-stop shop when filing.
formalityrequiredPrepare a French legal notice on legalone.fr
Use this when the user wants LegalOne to prepare their legal notice for an existing company (registered office transfer, change of manager or president, name, corporate purpose, share capital, duration, early dissolution, liquidation closure): creates a draft on legalone.fr from the SIREN and the facts the user gave, and returns the notice text, what is left to complete and a link, valid 7 days, that opens the pre-filled form. The user reviews, completes and pays on legalone.fr; nothing is published or paid here. Do not use for a company creation, and do not send home addresses, birth dates or contact details: they are completed on legalone.fr.
sirenrequirednewNameformalityrequireddepartmentnewAcronymnewCapitalnewPurposenewSeatCityofficerRoledecisionBodydecisionDatenewSeatCourt+25 more100% of the applicable checks met
How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.
claude mcp add --transport http legalone-entreprises https://mcp.legalone.fr/mcp{ "mcpServers": { "legalone-entreprises": { "url": "https://mcp.legalone.fr/mcp" } }}# Company profile by SIRENcurl -s https://api.legalone.fr/v1/entreprises/552032534 \ -H "Authorization: Bearer $LEGALONE_API_KEY"
# Search by start of name, or exact SIREN/SIRETcurl -s --get https://api.legalone.fr/v1/entreprises \ --data-urlencode "q=exemple" -H "Authorization: Bearer $LEGALONE_API_KEY"
# Latest BODACC noticescurl -s "https://api.legalone.fr/v1/entreprises/552032534/bodacc?limit=5" \ -H "Authorization: Bearer $LEGALONE_API_KEY"
# Normalise an addresscurl -s --get https://api.legalone.fr/v1/adresses/normaliser \ --data-urlencode "q=8 boulevard du Port 80000 Amiens" \ -H "Authorization: Bearer $LEGALONE_API_KEY"// sdk/typescript/legalone.ts — native fetch (Node 18+, browsers, Deno, Bun)import { LegalOne } from "./legalone.ts";
const api = new LegalOne({ apiKey: process.env.LEGALONE_API_KEY! });const company = await api.getCompany("552032534"); // null if not foundconsole.log(company?.data.name, company?.meta.attribution);# sdk/python/legalone.py — standard library only, Python 3.9+from legalone import LegalOne
api = LegalOne(api_key="lo_...")company = api.get_company("552032534") # None if not foundif company: print(company["data"]["name"], company["meta"]["attribution"])