Function handleGetCommitteeDocuments

handleGetCommitteeDocuments(args: unknown): Promise<ToolResult>
Handles the get_committee_documents MCP tool request.

Retrieves European Parliament committee documents, supporting single document lookup by docId or a paginated list.

Note: The EP API /committee-documents endpoint does not support year filtering. Only pagination (limit/offset) is available.
Parameters
- args: unknown
  Raw tool arguments, validated against GetCommitteeDocumentsSchema
Returns Promise<ToolResult>
MCP tool result containing either a single committee document or a paginated list of documents
Throws
- If args fails schema validation (e.g., missing required fields or invalid format)
- If the European Parliament API is unreachable or returns an error response
Example
```
// Single document lookup
const result = await handleGetCommitteeDocuments({ docId: 'A9-0001/2024' });
// Returns the full record for the specified committee document

// List documents (no year filter available in the EP API)
const list = await handleGetCommitteeDocuments({ limit: 25 });
// Returns up to 25 committee documents
```
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
- getCommitteeDocumentsToolMetadata for MCP schema registration
- handleGetCommitteeInfo for retrieving committee membership and structure
- Defined in tools/getCommitteeDocuments.ts:58

Function handleGetCommitteeDocuments

Parameters

Returns Promise<ToolResult>

Throws

Example

Security

Since

See

Settings