euparliamentmonitor 0.8.30 → 0.8.32

package/README.md

@@ -124,7 +124,7 @@ import {
 
 **MCP Server Integration**: The project uses the
 [European-Parliament-MCP-Server](https://github.com/Hack23/European-Parliament-MCP-Server)
-v1.2.6 for accessing real EU Parliament data via the Model Context Protocol.
+v1.2.8 for accessing real EU Parliament data via the Model Context Protocol.
 
 - **MCP Server Status**: ✅ Fully operational — 60+ EP data tools available
   (feeds, direct lookups, analytical tools, intelligence correlation)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "euparliamentmonitor",
-  "version": "0.8.30",
+  "version": "0.8.32",
   "type": "module",
   "description": "European Parliament Intelligence Platform - Monitor political activity with systematic transparency",
   "main": "scripts/index.js",
@@ -152,14 +152,14 @@
     "eslint-config-prettier": "10.1.8",
     "eslint-plugin-jsdoc": "62.9.0",
     "eslint-plugin-security": "4.0.0",
-    "eslint-plugin-sonarjs": "4.0.2",
+    "eslint-plugin-sonarjs": "4.0.3",
     "happy-dom": "20.9.0",
     "htmlhint": "1.9.2",
     "husky": "9.1.7",
     "jscpd": "4.0.9",
     "lint-staged": "16.4.0",
     "papaparse": "5.5.3",
-    "prettier": "3.8.2",
+    "prettier": "3.8.3",
     "ts-api-utils": "2.5.0",
     "tsx": "4.21.0",
     "typedoc": "0.28.19",
@@ -170,7 +170,7 @@
     "node": ">=25"
   },
   "dependencies": {
-    "european-parliament-mcp-server": "1.2.6"
+    "european-parliament-mcp-server": "1.2.8"
   },
   "optionalDependencies": {
     "worldbank-mcp": "1.0.1"

package/scripts/generators/motions-content.js

@@ -349,9 +349,13 @@ export function buildAdoptedTextsSection(adoptedTexts, language) {
     if (adoptedTexts.length === 0)
         return '';
     const heading = ADOPTED_TEXTS_HEADINGS[language] ?? ADOPTED_TEXTS_HEADINGS['en'] ?? 'Recently Adopted Texts';
-    const countFn = ADOPTED_TEXTS_COUNT_STRINGS[language] ?? ADOPTED_TEXTS_COUNT_STRINGS['en'];
+    const countFn = ADOPTED_TEXTS_COUNT_STRINGS[language] ??
+        ADOPTED_TEXTS_COUNT_STRINGS['en'] ??
+        ((n) => `${n} adopted texts`);
     const countText = countFn(adoptedTexts.length);
-    const unknownDate = ADOPTED_TEXTS_DATE_UNKNOWN_STRINGS[language] ?? ADOPTED_TEXTS_DATE_UNKNOWN_STRINGS['en'];
+    const unknownDate = ADOPTED_TEXTS_DATE_UNKNOWN_STRINGS[language] ??
+        ADOPTED_TEXTS_DATE_UNKNOWN_STRINGS['en'] ??
+        'Unknown date';
     // Group by date, sort most recent first
     const byDate = new Map();
     for (const item of adoptedTexts) {

package/scripts/generators/news-enhanced.js

@@ -118,8 +118,9 @@ let languagesInput = languagesArg
     ? (languagesArg.split(ARG_SEPARATOR)[1] ?? '').trim().toLowerCase()
     : 'en';
 // Expand presets
-if (LANGUAGE_PRESETS[languagesInput]) {
-    languagesInput = LANGUAGE_PRESETS[languagesInput].join(',');
+const presetLanguages = LANGUAGE_PRESETS[languagesInput];
+if (presetLanguages) {
+    languagesInput = presetLanguages.join(',');
 }
 const languages = languagesInput
     .split(',')
@@ -402,7 +403,7 @@ function wireAIMetadata() {
  */
 export function computeDedupSuffix(articleTypes, analysisDir) {
     const baseSlugNoRun = deriveArticleTypeSlug(articleTypes.filter((t) => VALID_ARTICLE_CATEGORIES.includes(t)));
-    const rawSuffix = analysisDir !== undefined && analysisDir.startsWith(baseSlugNoRun)
+    const rawSuffix = analysisDir?.startsWith(baseSlugNoRun)
         ? analysisDir.slice(baseSlugNoRun.length)
         : '';
     // Suffix validation patterns for dedup suffix extraction.

package/scripts/generators/pipeline/fetch-stage.js

@@ -427,17 +427,17 @@ export async function fetchWeekAheadData(client, dateRange) {
     const wasHalfOpen = mcpCircuitBreaker.getState() === 'HALF_OPEN';
     console.log(`${MCP_FETCH_PREFIX} Fetching week-ahead data from MCP (parallel)...`);
     const [plenarySessions, committeeInfo, documents, pipeline, questions, epEvents] = await Promise.allSettled([
-        client.getPlenarySessions({ startDate: dateRange.start, endDate: dateRange.end, limit: 50 }),
-        client.getCommitteeInfo({ limit: 20 }),
-        client.searchDocuments({ query: 'parliament', limit: 20 }),
+        client.getPlenarySessions({ dateFrom: dateRange.start, dateTo: dateRange.end, limit: 50 }),
+        client.getCommitteeInfo({ showCurrent: true }),
+        client.searchDocuments({ keyword: 'parliament', limit: 20 }),
         client.monitorLegislativePipeline({
             dateFrom: dateRange.start,
             dateTo: dateRange.end,
             status: 'ACTIVE',
             limit: 20,
         }),
-        client.getParliamentaryQuestions({ startDate: dateRange.start, limit: 20 }),
-        client.getEvents({ dateFrom: dateRange.start, dateTo: dateRange.end, limit: 20 }),
+        client.getParliamentaryQuestions({ dateFrom: dateRange.start, limit: 20 }),
+        client.getEvents({ limit: 20 }),
     ]);
     const allFailed = [
         plenarySessions,
@@ -459,7 +459,7 @@ export async function fetchWeekAheadData(client, dateRange) {
     const additionalEvents = parseEPEvents(epEvents, dateRange.start);
     const events = [...plenaryEvents, ...additionalEvents];
     return {
-        events: events.length > 0 ? events : [{ ...PLACEHOLDER_EVENTS[0], date: dateRange.start }],
+        events: events.length > 0 ? events : PLACEHOLDER_EVENTS.map((e) => ({ ...e, date: dateRange.start })),
         committees: parseCommitteeMeetings(committeeInfo, dateRange.start),
         documents: parseLegislativeDocuments(documents),
         pipeline: parseLegislativePipeline(pipeline),
@@ -728,7 +728,7 @@ export async function fetchCommitteeData(client, abbreviation) {
         return defaultResult;
     try {
         console.log(`${MCP_FETCH_PREFIX} Fetching committee info for ${abbreviation}...`);
-        const committeeResult = await callMCP(() => client.getCommitteeInfo({ committeeId: abbreviation }), null, `getCommitteeInfo(${abbreviation})`);
+        const committeeResult = await callMCP(() => client.getCommitteeInfo({ abbreviation }), null, `getCommitteeInfo(${abbreviation})`);
         if (committeeResult)
             applyCommitteeInfo(committeeResult, defaultResult, abbreviation);
     }
@@ -738,7 +738,7 @@ export async function fetchCommitteeData(client, abbreviation) {
     }
     try {
         console.log(`${MCP_FETCH_PREFIX} Fetching documents for ${abbreviation}...`);
-        const docsResult = await callMCP(() => client.searchDocuments({ query: abbreviation, limit: 5 }), null, `searchDocuments(${abbreviation})`);
+        const docsResult = await callMCP(() => client.searchDocuments({ keyword: abbreviation, limit: 5 }), null, `searchDocuments(${abbreviation})`);
         if (docsResult)
             applyDocuments(docsResult, defaultResult);
     }
@@ -1062,8 +1062,7 @@ const TIMEFRAME_FALLBACK_CHAIN = new Map([
     ['one-day', 'one-week'],
     ['one-week', 'one-month'],
     ['one-month', undefined],
-    ['three-months', undefined],
-    ['one-year', undefined],
+    ['custom', undefined],
 ]);
 /**
  * Get the next wider timeframe for fallback, or `undefined` if no fallback exists.

package/scripts/generators/sitemap.js

@@ -49,7 +49,7 @@ export function collectDocsHtmlFiles(dir, rootDir = PROJECT_ROOT) {
  */
 export function generateSitemap(articles, docsFiles = []) {
     const urls = [];
-    const today = new Date().toISOString().split('T')[0];
+    const today = new Date().toISOString().slice(0, 10);
     // Add home pages for each language
     for (const lang of ALL_LANGUAGES) {
         const filename = lang === 'en' ? 'index.html' : `index-${lang}.html`;
@@ -301,8 +301,8 @@ export function generateSitemapHTML(lang, articleInfos, hasDocsDir = false) {
     const skipLinkText = getLocalizedString(SKIP_LINK_TEXTS, lang);
     const dir = getTextDirection(lang);
     const year = new Date().getFullYear();
-    const sections = SITEMAP_SECTIONS[lang] ?? SITEMAP_SECTIONS['en'];
-    const docsLabels = DOCS_LABELS[lang] ?? DOCS_LABELS['en'];
+    const sections = (SITEMAP_SECTIONS[lang] ?? SITEMAP_SECTIONS['en']);
+    const docsLabels = (DOCS_LABELS[lang] ?? DOCS_LABELS['en']);
     const heroTitle = getLocalizedString(PAGE_TITLES, lang).split(' - ')[0] ?? '';
     const headerSubtitle = escapeHTML(getLocalizedString(HEADER_SUBTITLE_LABELS, lang));
     const themeToggleLabel = escapeHTML(getLocalizedString(THEME_TOGGLE_LABELS, lang));
@@ -539,7 +539,7 @@ function main() {
     // Generate sitemap HTML for each language
     let htmlGenerated = 0;
     for (const lang of ALL_LANGUAGES) {
-        const langArticles = articlesByLang.get(lang) || [];
+        const langArticles = articlesByLang.get(lang) ?? [];
         // Sort newest first
         langArticles.sort((a, b) => b.date.localeCompare(a.date));
         const html = generateSitemapHTML(lang, langArticles, hasDocsDir);

package/scripts/generators/strategies/committee-reports-strategy.js

@@ -249,7 +249,7 @@ function buildAdoptedTextsSection(feedData, lang) {
     const sections = displayOrder
         .filter((cat) => grouped[cat]?.length)
         .map((cat) => {
-        const items = grouped[cat];
+        const items = grouped[cat] ?? [];
         const listItems = items
             .map((item) => `<li class="adopted-text-item"><strong>${escapeHTML(item.title)}</strong> <span class="document-date">(${escapeHTML(item.date)})</span></li>`)
             .join('\n                ');

package/scripts/mcp/ep-mcp-client.d.ts

@@ -70,32 +70,28 @@ export declare class EuropeanParliamentMCPClient extends MCPConnection {
     /**
      * Get plenary sessions
      *
-     * @param options - Filter options. `dateFrom` is mapped to `startDate` and `dateTo` to `endDate`
-     *   per the tool schema when the canonical fields are absent.
+     * @param options - Filter options including dateFrom, dateTo, eventId, year, location
      * @returns Plenary sessions data
      */
     getPlenarySessions(options?: GetPlenarySessionsOptions): Promise<MCPToolResult>;
     /**
      * Search legislative documents
      *
-     * @param options - Search options (normalizes `query` to `keyword` if `keyword` is absent,
-     *   since the MCP tool schema requires the `keyword` parameter)
+     * @param options - Search options using v1.2.8 parameters: keyword, documentType, docId, etc.
      * @returns Search results
      */
     searchDocuments(options?: SearchDocumentsOptions): Promise<MCPToolResult>;
     /**
      * Get parliamentary questions
      *
-     * @param options - Filter options. `dateFrom` is mapped to `startDate` per the tool schema.
-     *   `dateTo` is intentionally ignored because the `get_parliamentary_questions` tool schema
-     *   only supports `startDate` as a date filter; passing `dateTo` would have no effect.
+     * @param options - Filter options including docId, type, author, topic, status, dateFrom, dateTo
      * @returns Parliamentary questions data
      */
     getParliamentaryQuestions(options?: GetParliamentaryQuestionsOptions): Promise<MCPToolResult>;
     /**
      * Get committee information
      *
-     * @param options - Filter options
+     * @param options - Filter options: id, abbreviation, showCurrent
      * @returns Committee info data
      */
     getCommitteeInfo(options?: GetCommitteeInfoOptions): Promise<MCPToolResult>;
@@ -123,21 +119,21 @@ export declare class EuropeanParliamentMCPClient extends MCPConnection {
     /**
      * Analyze coalition dynamics and cohesion
      *
-     * @param options - Options including optional political groups and date range
+     * @param options - Options including optional groupIds and date range
      * @returns Coalition cohesion and stress analysis
      */
     analyzeCoalitionDynamics(options?: AnalyzeCoalitionDynamicsOptions): Promise<MCPToolResult>;
     /**
      * Detect voting anomalies and party defections
      *
-     * @param options - Options including optional MEP id, political group, and date
+     * @param options - Options including optional MEP id, groupId, and date range
      * @returns Anomaly detection results
      */
     detectVotingAnomalies(options?: DetectVotingAnomaliesOptions): Promise<MCPToolResult>;
     /**
      * Compare political groups across dimensions
      *
-     * @param options - Options including required groups and optional metrics and date
+     * @param options - Options including required groupIds and optional dimensions and date range
      * @returns Cross-group comparative analysis
      */
     comparePoliticalGroups(options: ComparePoliticalGroupsOptions): Promise<MCPToolResult>;
@@ -151,7 +147,7 @@ export declare class EuropeanParliamentMCPClient extends MCPConnection {
     /**
      * Retrieve voting records with optional filters
      *
-     * @param options - Filter options (mepId, sessionId, limit)
+     * @param options - Filter options (sessionId, mepId, topic, dateFrom, dateTo, limit, offset)
      * @returns Voting records data
      */
     getVotingRecords(options?: VotingRecordsOptions): Promise<MCPToolResult>;
@@ -214,14 +210,14 @@ export declare class EuropeanParliamentMCPClient extends MCPConnection {
     /**
      * Get plenary speeches and debate contributions
      *
-     * @param options - Filter options including optional speechId or date range
+     * @param options - Filter options including optional speechId, dateFrom/dateTo (v1.2.8: year removed)
      * @returns Speeches data
      */
     getSpeeches(options?: GetSpeechesOptions): Promise<MCPToolResult>;
     /**
      * Get legislative procedures
      *
-     * @param options - Filter options including optional processId or year
+     * @param options - Filter options including optional processId (v1.2.8: year removed)
      * @returns Procedures data
      */
     getProcedures(options?: GetProceduresOptions): Promise<MCPToolResult>;
@@ -235,7 +231,7 @@ export declare class EuropeanParliamentMCPClient extends MCPConnection {
     /**
      * Get European Parliament events (hearings, conferences, seminars)
      *
-     * @param options - Filter options including optional eventId or date range
+     * @param options - Filter options including optional eventId, pagination only (v1.2.8: year/dateFrom/dateTo removed — EP API /events has no date filtering)
      * @returns Events data
      */
     getEvents(options?: GetEventsOptions): Promise<MCPToolResult>;
@@ -291,7 +287,7 @@ export declare class EuropeanParliamentMCPClient extends MCPConnection {
     /**
      * Get committee documents
      *
-     * @param options - Filter options including optional docId or year
+     * @param options - Filter options including optional docId (v1.2.8: year removed)
      * @returns Committee documents data
      */
     getCommitteeDocuments(options?: GetCommitteeDocumentsOptions): Promise<MCPToolResult>;
@@ -319,7 +315,7 @@ export declare class EuropeanParliamentMCPClient extends MCPConnection {
     /**
      * Get external documents (non-EP documents such as Council positions)
      *
-     * @param options - Filter options including optional docId or year
+     * @param options - Filter options including optional docId (v1.2.8: year removed)
      * @returns External documents data
      */
     getExternalDocuments(options?: GetExternalDocumentsOptions): Promise<MCPToolResult>;
@@ -382,10 +378,10 @@ export declare class EuropeanParliamentMCPClient extends MCPConnection {
     /**
      * Cross-tool OSINT intelligence correlation engine
      *
-     * @param options - Options including optional mepId and correlation scenarios
+     * @param options - Options including required mepIds, optional groups, sensitivityLevel, includeNetworkAnalysis
      * @returns Correlated intelligence alerts and insights
      */
-    correlateIntelligence(options?: CorrelateIntelligenceOptions): Promise<MCPToolResult>;
+    correlateIntelligence(options: CorrelateIntelligenceOptions): Promise<MCPToolResult>;
     /**
      * Retrieve precomputed European Parliament activity statistics (EP6–EP10, 2004–2025).
      * Includes yearly stats, category rankings, political landscape history, and

package/scripts/mcp/ep-mcp-client.js

@@ -29,7 +29,7 @@ const SERVER_HEALTH_FALLBACK = '{"server": null, "feeds": []}';
 /**
  * Classify an error message into a diagnostic error category.
  *
- * Maps EP MCP Server v1.2.6 structured error codes and generic HTTP/network
+ * Maps EP MCP Server v1.2.8 structured error codes and generic HTTP/network
  * errors into one of six broad categories used for logging and retry decisions:
  *
  * Returned categories (priority order):
@@ -45,7 +45,7 @@ const SERVER_HEALTH_FALLBACK = '{"server": null, "feeds": []}';
  */
 function classifyToolError(message) {
     const lowerMsg = message.toLowerCase();
-    // EP MCP Server v1.2.6 structured error codes (matched case-insensitively)
+    // EP MCP Server v1.2.8 structured error codes (matched case-insensitively)
     if (lowerMsg.includes('internal_error')) {
         return 'INTERNAL_ERROR';
     }
@@ -205,78 +205,38 @@ export class EuropeanParliamentMCPClient extends MCPConnection {
     /**
      * Get plenary sessions
      *
-     * @param options - Filter options. `dateFrom` is mapped to `startDate` and `dateTo` to `endDate`
-     *   per the tool schema when the canonical fields are absent.
+     * @param options - Filter options including dateFrom, dateTo, eventId, year, location
      * @returns Plenary sessions data
      */
     async getPlenarySessions(options = {}) {
-        return this.safeCallTool('get_plenary_sessions', () => {
-            const { dateFrom, dateTo, ...rest } = options;
-            const normalizedOptions = { ...rest };
-            if (normalizedOptions['startDate'] === undefined && dateFrom !== undefined) {
-                normalizedOptions['startDate'] = dateFrom;
-            }
-            if (normalizedOptions['endDate'] === undefined && dateTo !== undefined) {
-                normalizedOptions['endDate'] = dateTo;
-            }
-            return normalizedOptions;
-        }, '{"sessions": []}');
+        return this.safeCallTool('get_plenary_sessions', options, '{"sessions": []}');
     }
     /**
      * Search legislative documents
      *
-     * @param options - Search options (normalizes `query` to `keyword` if `keyword` is absent,
-     *   since the MCP tool schema requires the `keyword` parameter)
+     * @param options - Search options using v1.2.8 parameters: keyword, documentType, docId, etc.
      * @returns Search results
      */
     async searchDocuments(options = {}) {
-        return this.safeCallTool('search_documents', () => {
-            const { query, ...rest } = options;
-            const normalizedOptions = { ...rest };
-            // MCP tool schema expects 'keyword', not 'query'
-            if (normalizedOptions['keyword'] === undefined && query !== undefined) {
-                const trimmed = String(query).trim();
-                if (trimmed.length > 0) {
-                    normalizedOptions['keyword'] = trimmed;
-                }
-            }
-            return normalizedOptions;
-        }, DOCUMENTS_FALLBACK);
+        return this.safeCallTool('search_documents', options, DOCUMENTS_FALLBACK);
     }
     /**
      * Get parliamentary questions
      *
-     * @param options - Filter options. `dateFrom` is mapped to `startDate` per the tool schema.
-     *   `dateTo` is intentionally ignored because the `get_parliamentary_questions` tool schema
-     *   only supports `startDate` as a date filter; passing `dateTo` would have no effect.
+     * @param options - Filter options including docId, type, author, topic, status, dateFrom, dateTo
      * @returns Parliamentary questions data
      */
     async getParliamentaryQuestions(options = {}) {
-        return this.safeCallTool('get_parliamentary_questions', () => {
-            const { dateFrom, dateTo: _dateTo, ...rest } = options;
-            const toolOptions = { ...rest };
-            if (toolOptions['startDate'] === undefined && dateFrom !== undefined) {
-                toolOptions['startDate'] = dateFrom;
-            }
-            return toolOptions;
-        }, '{"questions": []}');
+        return this.safeCallTool('get_parliamentary_questions', options, '{"questions": []}');
     }
     /**
      * Get committee information
      *
-     * @param options - Filter options
+     * @param options - Filter options: id, abbreviation, showCurrent
      * @returns Committee info data
      */
     async getCommitteeInfo(options = {}) {
-        return this.safeCallTool('get_committee_info', () => {
-            const { committeeId, ...rest } = options;
-            const toolOptions = { ...rest };
-            // MCP tool schema expects 'abbreviation', not 'committeeId'
-            if (toolOptions['abbreviation'] === undefined && committeeId !== undefined) {
-                toolOptions['abbreviation'] = committeeId;
-            }
-            return toolOptions;
-        }, '{"committees": []}');
+        return this.safeCallTool('get_committee_info', options, '{"committees": []}');
     }
     /**
      * Monitor legislative pipeline
@@ -319,7 +279,7 @@ export class EuropeanParliamentMCPClient extends MCPConnection {
     /**
      * Analyze coalition dynamics and cohesion
      *
-     * @param options - Options including optional political groups and date range
+     * @param options - Options including optional groupIds and date range
      * @returns Coalition cohesion and stress analysis
      */
     async analyzeCoalitionDynamics(options = {}) {
@@ -328,7 +288,7 @@ export class EuropeanParliamentMCPClient extends MCPConnection {
     /**
      * Detect voting anomalies and party defections
      *
-     * @param options - Options including optional MEP id, political group, and date
+     * @param options - Options including optional MEP id, groupId, and date range
      * @returns Anomaly detection results
      */
     async detectVotingAnomalies(options = {}) {
@@ -337,19 +297,18 @@ export class EuropeanParliamentMCPClient extends MCPConnection {
     /**
      * Compare political groups across dimensions
      *
-     * @param options - Options including required groups and optional metrics and date
+     * @param options - Options including required groupIds and optional dimensions and date range
      * @returns Cross-group comparative analysis
      */
     async comparePoliticalGroups(options) {
-        const rawGroups = options && Array.isArray(options.groups) ? options.groups : [];
-        const groups = rawGroups
+        const groupIds = (Array.isArray(options.groupIds) ? options.groupIds : [])
             .map((g) => (typeof g === 'string' ? g.trim() : ''))
             .filter((g) => g.length > 0);
-        if (groups.length === 0) {
-            console.warn('compare_political_groups called without valid groups (non-empty string array required)');
+        if (groupIds.length === 0) {
+            console.warn('compare_political_groups called without valid groupIds (non-empty string array required)');
             return { content: [{ type: 'text', text: '{"comparison": {}}' }] };
         }
-        return this.safeCallTool('compare_political_groups', { ...options, groups }, '{"comparison": {}}');
+        return this.safeCallTool('compare_political_groups', { ...options, groupIds }, '{"comparison": {}}');
     }
     /**
      * Get detailed information about a specific MEP
@@ -367,7 +326,7 @@ export class EuropeanParliamentMCPClient extends MCPConnection {
     /**
      * Retrieve voting records with optional filters
      *
-     * @param options - Filter options (mepId, sessionId, limit)
+     * @param options - Filter options (sessionId, mepId, topic, dateFrom, dateTo, limit, offset)
      * @returns Voting records data
      */
     async getVotingRecords(options = {}) {
@@ -464,7 +423,7 @@ export class EuropeanParliamentMCPClient extends MCPConnection {
     /**
      * Get plenary speeches and debate contributions
      *
-     * @param options - Filter options including optional speechId or date range
+     * @param options - Filter options including optional speechId, dateFrom/dateTo (v1.2.8: year removed)
      * @returns Speeches data
      */
     async getSpeeches(options = {}) {
@@ -473,7 +432,7 @@ export class EuropeanParliamentMCPClient extends MCPConnection {
     /**
      * Get legislative procedures
      *
-     * @param options - Filter options including optional processId or year
+     * @param options - Filter options including optional processId (v1.2.8: year removed)
      * @returns Procedures data
      */
     async getProcedures(options = {}) {
@@ -491,7 +450,7 @@ export class EuropeanParliamentMCPClient extends MCPConnection {
     /**
      * Get European Parliament events (hearings, conferences, seminars)
      *
-     * @param options - Filter options including optional eventId or date range
+     * @param options - Filter options including optional eventId, pagination only (v1.2.8: year/dateFrom/dateTo removed — EP API /events has no date filtering)
      * @returns Events data
      */
     async getEvents(options = {}) {
@@ -571,7 +530,7 @@ export class EuropeanParliamentMCPClient extends MCPConnection {
     /**
      * Get committee documents
      *
-     * @param options - Filter options including optional docId or year
+     * @param options - Filter options including optional docId (v1.2.8: year removed)
      * @returns Committee documents data
      */
     async getCommitteeDocuments(options = {}) {
@@ -607,7 +566,7 @@ export class EuropeanParliamentMCPClient extends MCPConnection {
     /**
      * Get external documents (non-EP documents such as Council positions)
      *
-     * @param options - Filter options including optional docId or year
+     * @param options - Filter options including optional docId (v1.2.8: year removed)
      * @returns External documents data
      */
     async getExternalDocuments(options = {}) {
@@ -708,10 +667,14 @@ export class EuropeanParliamentMCPClient extends MCPConnection {
     /**
      * Cross-tool OSINT intelligence correlation engine
      *
-     * @param options - Options including optional mepId and correlation scenarios
+     * @param options - Options including required mepIds, optional groups, sensitivityLevel, includeNetworkAnalysis
      * @returns Correlated intelligence alerts and insights
      */
-    async correlateIntelligence(options = {}) {
+    async correlateIntelligence(options) {
+        if (!Array.isArray(options.mepIds) || options.mepIds.length === 0) {
+            console.warn('correlate_intelligence called without valid mepIds (non-empty string array required)');
+            return { content: [{ type: 'text', text: INTELLIGENCE_FALLBACK }] };
+        }
         return this.safeCallTool('correlate_intelligence', options, INTELLIGENCE_FALLBACK);
     }
     /**

package/scripts/mcp/mcp-connection.js

@@ -419,7 +419,7 @@ export class MCPConnection {
                 return trimmedKey;
             }
         }
-        const rawScheme = typeof process !== 'undefined' && process.env && process.env['EP_MCP_GATEWAY_AUTH_SCHEME'];
+        const rawScheme = typeof process !== 'undefined' && process.env?.['EP_MCP_GATEWAY_AUTH_SCHEME'];
         const scheme = typeof rawScheme === 'string' ? rawScheme.trim() : '';
         if (scheme && tokenRegex.test(scheme)) {
             return `${scheme} ${trimmedKey}`;
@@ -430,6 +430,9 @@ export class MCPConnection {
      * Attempt a single connection via MCP Gateway (HTTP transport)
      */
     async _attemptGatewayConnection() {
+        if (!this.gatewayUrl) {
+            throw new Error('Gateway URL not configured. Set the EP_MCP_GATEWAY_URL environment variable or provide the gatewayUrl constructor option.');
+        }
         try {
             const headers = {
                 'Content-Type': 'application/json',
@@ -562,17 +565,24 @@ export class MCPConnection {
     handleMessage(line) {
         try {
             const message = JSON.parse(line);
-            if (message.id && this.pendingRequests.has(message.id)) {
+            if (message.id !== null && message.id !== undefined && this.pendingRequests.has(message.id)) {
                 const pending = this.pendingRequests.get(message.id);
-                this.pendingRequests.delete(message.id);
-                if (message.error) {
-                    pending.reject(new Error(message.error.message ?? 'MCP server error'));
+                if (pending) {
+                    this.pendingRequests.delete(message.id);
+                    if (message.error) {
+                        pending.reject(new Error(message.error.message ?? 'MCP server error'));
+                    }
+                    else {
+                        pending.resolve(message.result);
+                    }
                 }
                 else {
-                    pending.resolve(message.result);
+                    // has() returned true but get() returned undefined — unexpected
+                    this.pendingRequests.delete(message.id);
+                    console.error(`MCP pending request ${String(message.id)} vanished before handling`);
                 }
             }
-            else if (!message.id && message.method) {
+            else if ((message.id === null || message.id === undefined) && message.method) {
                 console.log(`MCP Notification: ${message.method}`);
             }
         }
@@ -619,6 +629,9 @@ export class MCPConnection {
      * @returns Server response
      */
     async _sendGatewayRequest(method, params = {}) {
+        if (!this.gatewayUrl) {
+            throw new Error('Gateway URL not configured. Set EP_MCP_GATEWAY_URL or provide gatewayUrl in MCP client options.');
+        }
         const id = ++this.requestId;
         const request = {
             jsonrpc: '2.0',