{
  "markdown": "# fr-eli-mcp\n\n<!-- mcp-name: io.github.matematicsolutions/fr-eli-mcp -->\n\n\n## Install (one command)\n\nPublished on PyPI + MCP Registry (`io.github.matematicsolutions/fr-eli-mcp`). Run without cloning:\n\n```bash\nuvx fr-eli-mcp\n```\n\nRequires PISTE credentials in env: `PISTE_CLIENT_ID`, `PISTE_CLIENT_SECRET` (Legifrance/PISTE).\n\nConfigure your MCP client (stdio):\n\n```json\n{ \"mcpServers\": { \"fr-eli-mcp\": { \"command\": \"uvx\", \"args\": [\"fr-eli-mcp\"] } } }\n```\n\n### Windows 11 with Smart App Control\n\nSmart App Control blocks unsigned executables, which covers `uvx.exe`, `pip.exe`\nand the `fr-eli-mcp.exe` launcher that pip writes at install time. The `python.exe` and\n`py.exe` from the python.org installer are signed by the Python Software\nFoundation, so running the module through the interpreter works:\n\n```bash\npython -m pip install fr-eli-mcp\npython -m fr_eli_mcp\n```\n\n`pip.exe` is blocked for the same reason, so install with `python -m pip`, not\n`pip install`. If `python` is not on PATH, use the Windows launcher: `py -3 -m fr_eli_mcp`.\n\n```json\n{ \"mcpServers\": { \"fr-eli-mcp\": { \"command\": \"python\", \"args\": [\"-m\", \"fr_eli_mcp\"] } } }\n```\n\nDo not turn Smart App Control off to work around this - it cannot be re-enabled\nwithout reinstalling Windows.\n\nBuilding from source: see [Install](#install).\n\nAn MCP server for the **French Legifrance API** via [PISTE](https://piste.gouv.fr). It searches\nFrench legislation (LODA laws & decrees, codes), case law from three jurisdictions - Cour de\ncassation / cours d'appel (JURI), the **Conseil constitutionnel** (CONSTIT - QPC/DC decisions) and\nthe **administrative courts** (CETAT - Conseil d'Etat, cours administratives d'appel, tribunaux\nadministratifs) - plus **CNIL deliberations** (CNIL), **collective labour agreements** (KALI) and\n**company-level agreements** (ACCO), and returns verbatim text with verifiable citations. Part of\nthe **eu-legal-mcp** line of national legal connectors by [MateMatic](https://matematic.co).\n\nEvery response carries the citation contract: a stable `eli_uri`, a `human_readable_citation`\n(French convention) and a resolvable `source_url`.\n\n> **Read-only.** The server only queries Legifrance and writes a local audit log. It never modifies\n> official text and never sends anything beyond your query / document id.\n\n## Tools\n\n| Tool | What it does |\n| --- | --- |\n| `fr_search(query, fond, page_size)` | Keyword search a `fond`: `LODA` (laws & decrees), `CODE` (codes), `JURI` (Cour de cassation case law), `CONSTIT` (Conseil constitutionnel decisions), `CETAT` (administrative case law: Conseil d'Etat, CAA, TA), `CNIL` (CNIL deliberations), `KALI` (collective labour agreements), `ACCO` (company-level agreements). Returns hits with the citation contract; `CODE` hits expose matched `article_id`s. |\n| `fr_get_act(text_id, date)` | Consult a LODA law/decree by `LEGITEXT...` id. Returns metadata + a table of contents (`articles`). |\n| `fr_get_text(article_id)` | Verbatim text of a single article by `LEGIARTI...` id (legislation/codes) or `KALIARTI...` id (collective agreements). |\n| `fr_get_decision(decision_id)` | A court decision by `JURITEXT...`, `CONSTEXT...` or `CETATEXT...` id, with its **native `ecli`** (when populated), court, formation, solution and text. |\n| `fr_get_deliberation(deliberation_id)` | A CNIL deliberation by `CNILTEXT...` id (sanctions, authorizations, opinions) with its verbatim text and the citation `CNIL, deliberation n° ... du ...`. |\n| `fr_get_convention(convention_id)` | A collective labour agreement text by `KALITEXT...` id. Returns metadata + a table of contents whose `KALIARTI...` ids resolve via `fr_get_text`. |\n| `fr_get_company_agreement(agreement_id)` | A company-level agreement by `ACCOTEXT...` id - **metadata only** (company, SIRET, IDCC, sector, themes, unions, dates). Legifrance ships the full ACCO text only as a `.docx` attachment, so the tool cites `source_url` instead of re-serving it. |\n| `fr_coverage()` | Declare what this connector covers, when each family was captured, and - explicitly - what it does NOT cover. Every gap carries a fallback. |\n\n### Fonds covered (live totals, sandbox, 2026-07-08)\n\n| Fond | Corpus | Verified total |\n| --- | --- | --- |\n| `CNIL` | CNIL deliberations | >= 26 759 (`totalResultNumber` on a broad stopword query) |\n| `KALI` | Collective labour agreements (conventions collectives) | >= 35 790 |\n| `ACCO` | Company-level agreements | >= 387 656 |\n\n### Jurisdictions covered\n\n| Fond | Court(s) | Id prefix | Native ECLI |\n| --- | --- | --- | --- |\n| `JURI` | Cour de cassation, cours d'appel | `JURITEXT...` | Yes |\n| `CONSTIT` | Conseil constitutionnel (QPC + DC decisions, ~7 400+ live on PISTE) | `CONSTEXT...` | Yes (`ECLI:FR:CC:...`) |\n| `CETAT` | Conseil d'Etat, cours administratives d'appel (CAA), tribunaux administratifs (TA) | `CETATEXT...` | Yes for Conseil d'Etat; frequently `null` for CAA/TA (uneven ECLI coverage upstream - never fabricated) |\n\nConseil constitutionnel decisions get the French citation convention: `Cons. const., decision n°\n2025-1173 QPC du 7 novembre 2025 - [case name]`. JURI/CETAT decisions cite the Legifrance `titre`\n(court, formation, date, dossier number) verbatim.\n\n> **Judilibre** (`api.piste.gouv.fr/cassation/judilibre`) was evaluated as an alternative Cour de\n> cassation source but requires its own PISTE API subscription beyond the Legifrance one already\n> held by this connector. Re-verified 2026-07-08: a valid Legifrance token (granted scope\n> `openid resource.READ`) gets `403` on the sandbox host for every endpoint and auth shape tried\n> (`Bearer`, `KeyId`, no-auth -> `400`), and the sandbox application is rejected outright by the\n> production OAuth endpoint (`invalid_client`). Subscribing the Judilibre API to the PISTE\n> application is a dashboard action outside this connector. Not integrated - `JURI` already covers\n> Cour de cassation case law through the existing Legifrance subscription.\n\n### A note on ELI vs ECLI\n\nFrance has an official ELI scheme, but the PISTE `lf-engine-app` **consult API returns the native\nELI field `null` for the legislation we tested**. Following this line's rule - *say what you do not\nhave, never fabricate an ELI* - `eli_uri` carries the **stable, resolvable Legifrance resource URL**\n(CID-keyed), not a `/eli/...` string parsed from prose. Each response repeats this in `eli_note`.\n\nCase law is different: the API returns a **native, authoritative ECLI** for Cour de cassation (e.g.\n`ECLI:FR:CCASS:2025:C100399`), Conseil constitutionnel (e.g. `ECLI:FR:CC:2025:2025.1173.QPC`) and\nConseil d'Etat (e.g. `ECLI:FR:CECHR:2026:506507.20260529`), surfaced verbatim in `fr_get_decision`.\nCAA/TA decisions under `CETAT` frequently have no ECLI - the field is `null`, never fabricated.\n\n## Configuration\n\nLegifrance requires OAuth2 application credentials from a free PISTE account\n(`piste.gouv.fr` → *Applications* → subscribe to the Legifrance API → *OAuth Credentials*).\nCredentials are read from the environment only:\n\n| Variable | Meaning |\n| --- | --- |\n| `FR_ELI_OAUTH_URL` | OAuth token endpoint (sandbox default shown in `.mcp.json.example`). |\n| `FR_ELI_BASE_URL` | Legifrance `lf-engine-app` base. |\n| `FR_ELI_CLIENT_ID` | Your PISTE application client id (**required**). |\n| `FR_ELI_CLIENT_SECRET` | Your PISTE application client secret (**required**). |\n| `FR_ELI_CACHE_DIR` | Disk cache dir (default `~/.matematic/cache/fr-eli`). |\n| `FR_ELI_AUDIT_DIR` | Audit log dir (default `~/.matematic/audit`). |\n\nCopy `.mcp.json.example` to `.mcp.json` (gitignored) and fill in your credentials, or set the\nvariables in your host environment. The OAuth token is cached in memory and refreshed automatically.\n\n## Install\n\n```bash\npy -3.13 -m venv .venv\n.\\.venv\\Scripts\\python.exe -m pip install -e \".[dev]\"   # Windows\n# or: python -m pip install -e \".[dev]\"                  # POSIX\n```\n\n## Tests\n\n```bash\npytest tests/test_instructions_drift.py tests/test_parse.py   # offline, no creds\npytest tests/test_smoke.py -v                                 # live, needs PISTE creds in .env\n```\n\n## Distribution\n\nBecause Legifrance requires a PISTE key, this connector is distributed through the **PATRON /\nappliance** channel (governed), not casual drop-in download. See the eu-legal-mcp line notes.\n\n## Licence\n\nApache-2.0. Legifrance content is © the French Republic / DILA and subject to the Legifrance /\nPISTE terms of use; this software only retrieves and cites it.\n",
  "bytes": 8439,
  "sha": "694d8c2b771f1fc462a3ed78d64e50be7ad0965956a89295c8724ad92d9c239c",
  "repo_slug": "matematicsolutions/fr-eli-mcp",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_matematicsolutions_fr_eli_mcp_70e75936/readme"
}