All files / src/tools getMEPDeclarationsFeed.ts

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
9x
9x
9x
9x
8x
8x
7x
 
 
 
4x
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
/**
 * MCP Tool: get_mep_declarations_feed
 *
 * Get recently updated MEP declarations from the feed.
 *
 * **EP API Endpoint:**
 * - `GET /meps-declarations/feed`
 *
 * ISMS Policy: SC-002 (Input Validation), AC-003 (Least Privilege)
 */
 
import { GetMEPDeclarationsFeedSchema } from '../schemas/europeanParliament.js';
import { epClient } from '../clients/europeanParliamentClient.js';
import { buildToolResponse } from './shared/responseBuilder.js';
import type { ToolResult } from './shared/types.js';
 
/**
 * Handles the get_mep_declarations_feed MCP tool request.
 *
 * @param args - Raw tool arguments, validated against {@link GetMEPDeclarationsFeedSchema}
 * @returns MCP tool result containing recently updated MEP declaration data
 * @security Input is validated with Zod before any API call.
 */
export async function handleGetMEPDeclarationsFeed(args: unknown): Promise<ToolResult> {
  const params = GetMEPDeclarationsFeedSchema.parse(args);
  const apiParams: Record<string, unknown> = {};
  apiParams['timeframe'] = params.timeframe;
  Iif (params.startDate !== undefined) apiParams['startDate'] = params.startDate;
  if (params.workType !== undefined) apiParams['workType'] = params.workType;
  const result = await epClient.getMEPDeclarationsFeed(apiParams as Parameters<typeof epClient.getMEPDeclarationsFeed>[0]);
  return buildToolResponse(result);
}
 
/** Tool metadata for get_mep_declarations_feed */
export const getMEPDeclarationsFeedToolMetadata = {
  name: 'get_mep_declarations_feed',
  description: 'Get recently updated MEP declarations from the feed. Returns declarations published or updated during the specified timeframe. Data source: European Parliament Open Data Portal.',
  inputSchema: {
    type: 'object' as const,
    properties: {
      timeframe: {
        type: 'string',
        description: 'Timeframe for the feed (today, one-day, one-week, one-month, custom)',
        enum: ['today', 'one-day', 'one-week', 'one-month', 'custom'],
        default: 'one-week'
      },
      startDate: { type: 'string', description: 'Start date (YYYY-MM-DD) — required when timeframe is "custom"' },
      workType: { type: 'string', description: 'Work type filter' }
    }
  }
};