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

    Class VotingClient

    Sub-client for voting records and speeches EP API endpoints.

    Hierarchy (View Summary)

    Index

    Constructors

    constructor

    Properties

    baseURL cache enableRetry maxResponseBytes maxRetries rateLimiter timeoutMs

    Methods

    clearCache evictFromCache fetchVoteResultsForSession fetchVoteResultsFromRecentMeetings filterVotingRecords get getCacheStats getSpeechById getSpeeches getVotingRecords transformSpeech transformVoteResult

    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

    • Evicts a single cache entry matching the given endpoint and params. Sub-clients use this when they detect that a successfully-fetched payload is a content-pending sentinel that must not be served from cache for the remainder of the TTL — eviction lets availability recover as soon as the upstream document is enriched.

      Parameters

      • endpoint: string

        API endpoint path (same value passed to get)

      • Optionalparams: Record<string, unknown>

        Optional query parameters (same value passed to get)

      Returns void

    • 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

      • OptionalminimumTimeoutMs: number

        Optional per-request minimum timeout in milliseconds. When provided, the effective timeout is Math.max(minimumTimeoutMs, this.timeoutMs), so the global timeout (set via --timeout or EP_REQUEST_TIMEOUT_MS) can still extend it beyond the per-endpoint minimum. Use for known slow EP API endpoints such as procedures/feed.

      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 plenary speeches. EP API Endpoint: GET /speeches

      Note: The EP API /speeches endpoint does not support a year query parameter. It supports sitting-date (range start) and sitting-date-end (range end) for date filtering.

      Use dateFrom / dateTo (YYYY-MM-DD) for date-range queries — these are mapped to sitting-date / sitting-date-end.

      Parameters

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

      Returns Promise<PaginatedResponse<Speech>>

    • Retrieves voting records with filtering by session, topic, and date.

      EP API Endpoint: GET /meetings/{sitting-id}/vote-results

      Parameters

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

        sessionId, topic, dateFrom, dateTo, limit, offset

      Returns Promise<PaginatedResponse<VotingRecord>>

      Paginated voting records list

      Audit logged per GDPR Article 30

    Settings

    Member Visibility

    On This Page

    Constructors
    Properties
    Methods