European Parliament MCP Server API - v1.1.16
    Preparing search index...

    Class PlenaryClient

    Sub-client for plenary sessions and meeting-related EP API endpoints.

    Hierarchy (View Summary)

    Index

    Constructors

    constructor

    Properties

    baseURL cache enableRetry maxResponseBytes maxRetries rateLimiter timeoutMs

    Methods

    buildMeetingsAPIParams clearCache get getCacheStats getEventById getEvents getEventsFeed getMeetingActivities getMeetingById getMeetingDecisions getMeetingForeseenActivities getMeetingPlenarySessionDocumentItems getMeetingPlenarySessionDocuments getPlenarySessions transformDocument transformEvent transformMeetingActivity transformPlenarySession

    Constructors

    Properties

    baseURL: string

    European Parliament API base URL.

    cache: LRUCache<string, Record<string, unknown>>

    LRU cache for API responses.

    enableRetry: boolean

    Enable automatic retry on transient failures.

    maxResponseBytes: number

    Maximum allowed response body size in bytes.

    maxRetries: number

    Maximum number of retry attempts.

    rateLimiter: RateLimiter

    Token bucket rate limiter.

    timeoutMs: number

    Request timeout in milliseconds.

    Methods

    • Private

      Maps internal params to EP API query parameters for meetings.

      The EP API /meetings endpoint supports year for filtering by calendar year. The date-from / date-to parameters are also forwarded when present (useful for sub-year ranges).

      Parameters

      • params: {
            dateFrom?: string;
            dateTo?: string;
            limit?: number;
            offset?: number;
            year?: number;
        }

      Returns Record<string, unknown>

    • Protected

      Executes a cached, rate-limited GET request to the EP API.

      Type Parameters

      • T extends Record<string, unknown>

        Expected response type (extends Record<string, unknown>)

      Parameters

      • endpoint: string

        API endpoint path (relative to baseURL)

      • Optionalparams: Record<string, unknown>

        Optional query parameters

      Returns Promise<T>

      Promise resolving to the typed API response

      On HTTP errors, network failures, or parse failures

    • Returns cache statistics for monitoring and debugging.

      Returns { hitRate: number; hits: number; maxSize: number; misses: number; size: number }

      { size, maxSize, hitRate, hits, misses }

    • Returns EP events (hearings, conferences, etc.). EP API Endpoint: GET /events

      The EP API supports filtering by year (recommended for annual counts).

      Parameters

      • params: {
            dateFrom?: string;
            dateTo?: string;
            limit?: number;
            offset?: number;
            year?: number;
        } = {}

      Returns Promise<PaginatedResponse<EPEvent>>

    • Retrieves recently updated events via the feed endpoint. EP API Endpoint: GET /events/feed

      Parameters

      • params: { activityType?: string; startDate?: string; timeframe?: string } = {}

      Returns Promise<JSONLDResponse<Record<string, unknown>>>

    • Retrieves plenary sessions with year/date and location filtering.

      EP API Endpoint: GET /meetings

      The EP API supports filtering by year (recommended for annual counts). dateFrom / dateTo are also forwarded but may be ignored by the API for certain endpoints.

      Parameters

      • params: {
            dateFrom?: string;
            dateTo?: string;
            limit?: number;
            location?: string;
            offset?: number;
            year?: number;
        }

        year, dateFrom, dateTo, location, limit, offset

      Returns Promise<PaginatedResponse<PlenarySession>>

      Paginated plenary session list

    Settings

    Member Visibility

    On This Page

    Constructors
    Properties
    Methods