EP Votes

Use this when you need to find a European Parliament dossier (legislative or non-legislative procedure), an MEP, a committee, a political group or an EP document by name, topic or reference, and you do not know its id yet. Returns up to 15 matching records with their ids and epvotes.com urls; pass an id to get_dossier or get_mep next. Matches words in titles and names (e.g. "digital euro", "Metsola", "ECON", "2023/0212(COD)"). Do not use it for votes of a day; use list_votes.

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "minLength": 2,
      "maxLength": 200,
      "description": "Words to match: a dossier title, procedure reference, MEP name, committee code or document number."
    },
    "type": {
      "type": "string",
      "enum": [
        "any",
        "dossier",
        "mep",
        "committee",
        "group",
        "document"
      ],
      "default": "any",
      "description": "Limit the search to one kind of record."
    }
  },
  "required": [
    "query"
  ],
  "additionalProperties": false
}

Use this when the user asks what the European Parliament voted on a sitting day, this week, between two dates or on a subject, e.g. "what did Parliament vote today" or "votes on Ukraine in October". Without arguments it returns the latest sitting day; with only a query it searches the last 92 days. Votes are grouped by agenda item; each item has its deciding (final) vote with result and totals and the ids of its other votes for get_vote. Lists at most 40 items.

{
  "type": "object",
  "properties": {
    "day": {
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
      "description": "One sitting day, YYYY-MM-DD."
    },
    "from": {
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
      "description": "Start of a date range, YYYY-MM-DD (with to)."
    },
    "to": {
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
      "description": "End of a date range, YYYY-MM-DD (with from)."
    },
    "this_week": {
      "type": "boolean",
      "description": "All votes of the current week."
    },
    "query": {
      "type": "string",
      "maxLength": 120,
      "description": "Keep only agenda items whose topic, title or vote labels contain these words, e.g. \"psychosocial\"."
    }
  },
  "additionalProperties": false
}

Use this when you need the result of one European Parliament roll-call vote: totals, the split by political group and by country, the dossier it belongs to, and optionally how individual MEPs voted. Takes a vote id from list_votes, get_dossier or get_mep (or an epvotes.com/votes/<id> url). Set members to a group (e.g. "EPP", "S&D") or a country code (e.g. "DE", "FRA") to list those MEPs' votes.

{
  "type": "object",
  "properties": {
    "vote_id": {
      "type": "string",
      "description": "The numeric vote id, e.g. \"198885\"."
    },
    "members": {
      "type": "string",
      "maxLength": 40,
      "description": "Optional: list individual MEP votes for one political group or one country. \"all\" lists every MEP."
    }
  },
  "required": [
    "vote_id"
  ],
  "additionalProperties": false
}

Use this when the user asks about one European Parliament dossier (procedure): what it is, its type, lead committee, rapporteurs, the steps so far in Parliament, its plenary votes, and the Legislative Observatory summary. Takes a procedure reference such as "2023/0212(COD)" or an id such as "2023-0212" (use search_parliament first if you only know the title).

{
  "type": "object",
  "properties": {
    "dossier": {
      "type": "string",
      "maxLength": 120,
      "description": "Procedure reference \"2023/0212(COD)\" or id \"2023-0212\"."
    },
    "votes_page": {
      "type": "integer",
      "minimum": 1,
      "maximum": 20,
      "default": 1,
      "description": "Page of plenary votes, 50 per page."
    }
  },
  "required": [
    "dossier"
  ],
  "additionalProperties": false
}

Use this when the user asks about one Member of the European Parliament: country, political group, committees, how often they vote with their group, where they broke with it, and their recent roll-call votes. Takes an MEP id or a name. Set topic to keep only votes whose label, agenda item topic or dossier title contains those words (e.g. "digital euro", "Mercosur"). Set from and to to read one period; page through all votes of the term with page.

{
  "type": "object",
  "properties": {
    "mep": {
      "type": "string",
      "maxLength": 120,
      "description": "The MEP id (e.g. \"124834\") or name (e.g. \"Martin Sonneborn\")."
    },
    "topic": {
      "type": "string",
      "maxLength": 120,
      "description": "Optional: only votes whose label, agenda item topic or dossier title contains these words."
    },
    "from": {
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
      "description": "Optional: only votes on or after this day, YYYY-MM-DD."
    },
    "to": {
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
      "description": "Optional: only votes on or before this day, YYYY-MM-DD."
    },
    "page": {
      "type": "integer",
      "minimum": 1,
      "maximum": 400,
      "default": 1,
      "description": "Page of votes, 25 per page, newest first (400 pages reach 10,000 votes; use from and to for older votes of a busy term)."
    }
  },
  "required": [
    "mep"
  ],
  "additionalProperties": false
}

Use this when the user wants to compare how two or three European Parliament political groups voted across recent final votes on texts (amendments left out), e.g. "how often did EPP and S&D vote the same way". Groups: The Left, S&D, Greens/EFA, Renew, EPP, ECR, PfE, ESN.

{
  "type": "object",
  "properties": {
    "groups": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "minItems": 2,
      "maxItems": 3,
      "description": "Two or three group names, e.g. [\"EPP\", \"S&D\"]."
    },
    "from": {
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
      "description": "Optional start date, YYYY-MM-DD."
    },
    "to": {
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
      "description": "Optional end date, YYYY-MM-DD."
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 50,
      "default": 25,
      "description": "Newest votes to compare."
    }
  },
  "required": [
    "groups"
  ],
  "additionalProperties": false
}