Function handleGetProcedures

handleGetProcedures(args: unknown): Promise<ToolResult>
Handles the get_procedures MCP tool request.

Retrieves European Parliament legislative procedures enabling end-to-end legislative tracking, outcome prediction, and timeline analysis. Supports both a single-procedure lookup by processId and a paginated list optionally filtered by year.
Parameters
- args: unknown
  Raw tool arguments, validated against GetProceduresSchema
Returns Promise<ToolResult>
MCP tool result containing procedure data (single procedure or paginated list)
Throws
- If args fails schema validation (e.g., invalid field types or formats)
- If the European Parliament API is unreachable or returns an error response
Example
```
// Single procedure lookup
const single = await handleGetProcedures({ processId: '2023/0132(COD)' });
// Returns the legislative procedure for the Artificial Intelligence Act

// List procedures from 2024
const list = await handleGetProcedures({ year: 2024, limit: 50, offset: 0 });
// Returns up to 50 legislative procedures initiated in 2024
```
Security
- Input is validated with Zod before any API call.
- Personal data in responses is minimised per GDPR Article 5(1)(c).
- All requests are rate-limited and audit-logged per ISMS Policy AU-002.
Since
0.8.0
See
- getProceduresToolMetadata for MCP schema registration
- handleGetProcedureEvents for retrieving events linked to a specific procedure
- Defined in tools/getProcedures.ts:56