Nosdeputes Fr

List Deputies

list_deputies

Read-onlyIdempotent

List French Assemblée nationale deputies with party, département, profession and contact details. Defaults to the 16th legislature (2022–2024, 618 deputies) — NosDéputés never ingested the 17th, so this is a historical record, not the currently sitting chamber.

Input Schema

TableJSON Schema

Name	Required	Description
`group`	No	Group acronym, matched against `groupe_sigle`. The 16th legislature uses REN (193), RN (90), LFI (76), LR (62), MODEM (58), HOR (34), SOC (31), GDR (24), LIOT, ECOLO, NI. Call list_groups for the full set.
`departement`	No	Département name (matched against `nom_circo`) or 2-3 char code (`num_deptmt`), e.g. "Paris" or "75".
`legislature`	No	16 (2022–2024, default) · 15 (2017–2022) · 14 (2012–2017). No 17th exists.

Output Schema

TableJSON Schema

Name	Required	Description
`count`	No	Number of deputies returned. Present only when a filter was applied.
`deputes`	Yes	Deputies, each wrapped in a `depute` envelope by the upstream API.
`filters`	No	Echo of the filters actually applied. Absent on an unfiltered call.
`filtered_from`	No	Total before filtering. Present only when a filter was applied.

Schema Changelog

Changes observed during successful MCP inspections.

Changed6 schema fields changedAug 3, 2026

changedOutput schema / properties / count / description

Previous value: -"Number of items returned."New value: +"Number of deputies returned. Present only when a filter was applied."

addedOutput schema / properties / deputes

Added value: +{
+  "description": "Deputies, each wrapped in a `depute` envelope by the upstream API.",
+  "items": {
+    "properties": {
+      "depute": {
+        "properties": {
+          "adresses": {
+            "description": "Contact addresses",
+            "items": {},
+            "type": "array"
+          },
+          "ancien_depute": {
+            "description": "1 if the mandate has ended",
+            "type": "integer"
+          },
+          "anciens_autres_mandats": {
+            "description": "Other past mandates",
+            "items": {},
+            "type": "array"
+          },
+          "anciens_mandats": {
+            "description": "Past mandates",
+            "items": {},
+            "type": "array"
+          },
+          "autres_mandats": {
+            "description": "Other current mandates",
+            "items": {},
+            "type": "array"
+          },
+          "collaborateurs": {
+            "description": "Parliamentary assistants",
+            "items": {},
+            "type": "array"
+          },
+          "date_naissance": {
+            "description": "Birth date (YYYY-MM-DD)",
+            "type": "string"
+          },
+          "emails": {
+            "description": "Contact emails",
+            "items": {},
+            "type": "array"
+          },
+          "groupe_sigle": {
+            "description": "Political group acronym (REN / LFI / RN …)",
+            "type": "string"
+          },
+          "id": {
+            "description": "Deputy numeric identifier",
+            "type": "integer"
+          },
+          "id_an": {
+            "description": "Assemblée nationale identifier",
+            "type": "string"
+          },
+          "lieu_naissance": {
+            "description": "Place of birth",
+            "type": "string"
+          },
+          "mandat_debut": {
+            "description": "Mandate start date",
+            "type": "string"
+          },
+          "mandat_fin": {
+            "description": "Mandate end date",
+            "type": "string"
+          },
+          "nb_mandats": {
+            "description": "Number of mandates held",
+            "type": "integer"
+          },
+          "nom": {
+            "description": "Full name",
+            "type": "string"
+          },
+          "nom_circo": {
+            "description": "Constituency name",
+            "type": "string"
+          },
+          "nom_de_famille": {
+            "description": "Surname",
+            "type": "string"
+          },
+          "num_circo": {
+            "description": "Constituency number",
+            "type": "integer"
+          },
+          "num_deptmt": {
+            "description": "Département code",
+            "type": "string"
+          },
+          "parti_ratt_financier": {
+            "description": "Party for campaign-finance attachment",
+            "type": "string"
+          },
+          "place_en_hemicycle": {
+            "description": "Hemicycle seat position",
+            "type": "string"
+          },
+          "prenom": {
+            "description": "First name",
+            "type": "string"
+          },
+          "profession": {
+            "description": "Stated profession; null when not declared",
+            "type": [
+              "string",
+              "null"
+            ]
+          },
+          "sexe": {
+            "description": "Gender (H/F)",
+            "type": "string"
+          },
+          "sites_web": {
+            "description": "Personal websites",
+            "items": {},
+            "type": "array"
+          },
+          "slug": {
+            "description": "NosDéputés URL slug",
+            "type": "string"
+          },
+          "twitter": {
+            "description": "Twitter handle",
+            "type": "string"
+          },
+          "url_an": {
+            "description": "Official Assemblée profile URL",
+            "type": "string"
+          },
+          "url_nosdeputes": {
+            "description": "NosDéputés profile URL",
+            "type": "string"
+          },
+          "url_nosdeputes_api": {
+            "description": "NosDéputés API URL",
+            "type": "string"
+          }
+        },
+        "type": "object"
+      }
+    },
+    "type": "object"
+  },
+  "type": "array"
+}

addedOutput schema / properties / filtered_from

Added value: +{
+  "description": "Total before filtering. Present only when a filter was applied.",
+  "type": "integer"
+}

addedOutput schema / properties / filters

Added value: +{
+  "description": "Echo of the filters actually applied. Absent on an unfiltered call.",
+  "type": "object"
+}

removedOutput schema / properties / items

Removed value: -{
-  "items": {
-    "properties": {
-      "circonscription": {
-        "description": "Constituency number",
-        "type": "string"
-      },
-      "date_naissance": {
-        "description": "Birth date (YYYY-MM-DD)",
-        "type": "string"
-      },
-      "departement": {
-        "description": "Département code or name",
-        "type": "string"
-      },
-      "email": {
-        "description": "Contact email",
-        "type": "string"
-      },
-      "groupe": {
-        "description": "Political group acronym",
-        "type": "string"
-      },
-      "id": {
-        "description": "Deputy numeric identifier",
-        "type": "number"
-      },
-      "nom": {
-        "description": "Full name",
-        "type": "string"
-      },
-      "photo_url": {
-        "description": "Deputy photo URL",
-        "type": "string"
-      },
-      "place_hemicycle": {
-        "description": "Hemicycle seat position",
-        "type": "string"
-      },
-      "prenom": {
-        "description": "First name",
-        "type": "string"
-      },
-      "sexe": {
-        "description": "Gender (M/F)",
-        "type": "string"
-      },
-      "slug": {
-        "description": "NosDéputés URL slug",
-        "type": "string"
-      },
-      "twitter": {
-        "description": "Twitter handle",
-        "type": "string"
-      },
-      "url_assemblee": {
-        "description": "Official Assemblée website URL",
-        "type": "string"
-      },
-      "url_nosdeputes": {
-        "description": "Full NosDéputés profile URL",
-        "type": "string"
-      }
-    },
-    "type": "object"
-  },
-  "type": "array"
-}

changedOutput schema / required

Previous value: -[
-  "items",
-  "count"
-]New value: +[
+  "deputes"
+]

Changed4 schema fields changedAug 2, 2026

changedInput schema / examples

Previous value: -[
-  {
-    "active": true
-  },
-  {
-    "active": true,
-    "departement": "Paris",
-    "group": "RE"
-  }
-]New value: +[
+  {
+    "group": "LFI"
+  },
+  {
+    "departement": "Paris",
+    "group": "LFI"
+  }
+]

removedInput schema / properties / active

Removed value: -{
-  "description": "Only currently active (default true)",
-  "type": "boolean"
-}

changedInput schema / properties / departement / description

Previous value: -"Département name or code"New value: +"Département name (matched against `nom_circo`) or 2-3 char code (`num_deptmt`), e.g. \"Paris\" or \"75\"."

changedInput schema / properties / group / description

Previous value: -"Group acronym (e.g. \"RE\", \"LFI-NUPES\")"New value: +"Group acronym, matched against `groupe_sigle`. The 16th legislature uses REN (193), RN (90), LFI (76), LR (62), MODEM (58), HOR (34), SOC (31), GDR (24), LIOT, ECOLO, NI. Call list_groups for the full set."

Changed1 schema field changedAug 1, 2026

changedInput schema / properties / legislature / description

Previous value: -"Legislature number (default current)"New value: +"16 (2022–2024, default) · 15 (2017–2022) · 14 (2012–2017). No 17th exists."

Changed2 schema fields changedMay 27, 2026

addedInput schema / examples

Added value: +[
+  {
+    "active": true
+  },
+  {
+    "active": true,
+    "departement": "Paris",
+    "group": "RE"
+  }
+]

changedOutput schema / (root)

Previous value: -nullNew value: +{
+  "properties": {
+    "count": {
+      "description": "Number of items returned.",
+      "type": "integer"
+    },
+    "items": {
+      "items": {
+        "properties": {
+          "circonscription": {
+            "description": "Constituency number",
+            "type": "string"
+          },
+          "date_naissance": {
+            "description": "Birth date (YYYY-MM-DD)",
+            "type": "string"
+          },
+          "departement": {
+            "description": "Département code or name",
+            "type": "string"
+          },
+          "email": {
+            "description": "Contact email",
+            "type": "string"
+          },
+          "groupe": {
+            "description": "Political group acronym",
+            "type": "string"
+          },
+          "id": {
+            "description": "Deputy numeric identifier",
+            "type": "number"
+          },
+          "nom": {
+            "description": "Full name",
+            "type": "string"
+          },
+          "photo_url": {
+            "description": "Deputy photo URL",
+            "type": "string"
+          },
+          "place_hemicycle": {
+            "description": "Hemicycle seat position",
+            "type": "string"
+          },
+          "prenom": {
+            "description": "First name",
+            "type": "string"
+          },
+          "sexe": {
+            "description": "Gender (M/F)",
+            "type": "string"
+          },
+          "slug": {
+            "description": "NosDéputés URL slug",
+            "type": "string"
+          },
+          "twitter": {
+            "description": "Twitter handle",
+            "type": "string"
+          },
+          "url_assemblee": {
+            "description": "Official Assemblée website URL",
+            "type": "string"
+          },
+          "url_nosdeputes": {
+            "description": "Full NosDéputés profile URL",
+            "type": "string"
+          }
+        },
+        "type": "object"
+      },
+      "type": "array"
+    }
+  },
+  "required": [
+    "items",
+    "count"
+  ],
+  "type": "object"
+}

First observedMay 13, 2026

TDQS

A4.5/5.0

Behavior5/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

Beyond the readOnly/idempotent annotations, the description reveals a critical behavioral quirk: NosDéputés never ingested the 17th legislature, making this a frozen historical record. This is essential information that could otherwise lead an agent to incorrectly assume current data. The mention of 618 deputies also sets expectations about the result set.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is two sentences with no wasted words: the first delivers the core function and data fields, the second explains the default legislature and historical caveat. It is front-loaded and well-structured.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness5/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Given the output schema exists and the input schema is fully documented, the description covers all essential context: what is listed, what fields are included, the default legislature, and the critical historical caveat. There is no significant missing information for an agent to correctly select and invoke this tool.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

The input schema has 100% parameter description coverage, documenting all three parameters (group, departement, legislature) with examples and matching field names. The tool description adds no extra parameter-level semantics beyond mentioning 'party' and 'département', which are already in the schema.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description clearly states the action ('List') and resource ('French Assemblée nationale deputies') with specific data fields (party, département, profession, contact details). It also distinguishes this tool as a historical record for the 16th legislature, setting it apart from any current-chamber listing tool.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines4/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The description gives clear context, including the default legislature and an explicit warning that this is not the currently sitting chamber. However, it does not name alternative tools (e.g., get_deputy) for current data, so it falls short of providing explicit alternatives.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

All Nosdeputes Fr tools Inspect

Try in Browser

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Glama MCP Gateway

Add one secure layer between your agents and this server.