Function handleGetControlledVocabularies

handleGetControlledVocabularies(args: unknown): Promise<ToolResult>
Handles the get_controlled_vocabularies MCP tool request.

Retrieves European Parliament controlled vocabularies—standardised classification terms used across EP datasets. Supports both a paginated list view and a single-vocabulary lookup when vocId is provided. These vocabularies are essential for accurate query construction and data interpretation across other EP API tools.
Parameters
- args: unknown
  Raw tool arguments, validated against GetControlledVocabulariesSchema
Returns Promise<ToolResult>
MCP tool result containing vocabulary data (single vocabulary 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 vocabulary lookup
const single = await handleGetControlledVocabularies({ vocId: 'activities-type' });
// Returns the controlled vocabulary for activity types

// List all vocabularies
const list = await handleGetControlledVocabularies({ limit: 50, offset: 0 });
// Returns up to 50 controlled vocabulary entries
```
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
- getControlledVocabulariesToolMetadata for MCP schema registration
- handleSearchDocuments for tools that consume vocabulary terms as filter values
- Defined in tools/getControlledVocabularies.ts:55

Function handleGetControlledVocabularies

Parameters

Returns Promise<ToolResult>

Throws

Example

Security

Since

See

Settings