European Parliament MCP Server – Political Intelligence for AI Agents

Hack23 AB released an open-source Model Context Protocol (MCP) server that gives AI agents structured access to European Parliament open data, including MEP profiles, legislative documents, and OSINT analytics tools. The server aims to democratize political intelligence by enabling citizens and journalists to perform automated coalition analysis and influence scoring that previously required professional research teams.

Model Context Protocol Server for European Parliament Open Data 🇪🇺 EU parliamentary intelligence for AI agents · 🕵️ 15 OSINT analytics tools · 🏛️ Full EP API v2 coverage · 🛡️ ISMS-aligned · 🔒 GDPR-by-design · 📦 SLSA Level 3 The canonical TypeScript MCP bridge between the European Parliament Open Data Portal and any MCP-aware AI client — Claude Desktop, VS Code, Cursor, GitHub Copilot. Powers the EU Parliament Monitor https://euparliamentmonitor.com AI newsroom and is a sister project to Riksdagsmonitor https://riksdagsmonitor.com in the Hack23 https://hack23.com political-intelligence portfolio. The European Parliament MCP Server implements the Model Context Protocol MCP https://spec.modelcontextprotocol.io/ to provide AI assistants, IDEs, and other MCP clients with structured access to European Parliament open datasets. Access information about MEPs, plenary sessions, committees, legislative documents, and parliamentary questions through a secure, type-safe TypeScript/Node.js implementation. - 🔌 Full MCP Implementation : 63 tools 9 core + 3 advanced + 15 OSINT + 8 Phase 4 + 15 Phase 5 + 13 feed , 9 Resources, and 7 Prompts - 🏛️ Complete EP API v2 Coverage : All European Parliament Open Data API endpoints covered - 🕵️ OSINT Intelligence : MEP influence scoring, coalition analysis, anomaly detection - 🔒 Security First : ISMS-compliant, GDPR-ready, SLSA Level 3 provenance - 🚀 High Performance : <200ms API responses, intelligent caching, rate limiting - 📊 Type Safety : TypeScript strict mode + Zod runtime validation - 🧪 Well-Tested : 80%+ code coverage, 1130+ unit tests, 71 E2E test cases - 📚 Complete Documentation : Architecture, TypeDoc API HTML + Markdown , security guidelines Runtime : Node.js 26.x Primary compiler : TypeScript 7 RC via the typescript-7 alias node modules/typescript-7/bin/tsc Compatibility layer : @typescript/typescript6 remains available so existing 6.x-based tooling can continue using tsc6 and the TypeScript 6 API Core platform : @modelcontextprotocol/sdk 1.29.0, zod 4.4.3, vitest 4.1.10 This MCP server is the EU data backbone of Hack23 https://hack23.com/ 's mission to disrupt parliamentary journalism with AI-generated political intelligence and real-time accountability analysis — increasing democratic transparency through structured open-source intelligence OSINT tradecraft applied to public legislative data. Hack23 AB builds open-source intelligence platforms that put rigorous, evidence-based political analysis in the hands of every citizen, journalist, researcher and policymaker. By combining MCP servers, agentic AI newsrooms, and open parliamentary data, we produce automated intelligence products — coalition analysis, voting-pattern decoding, MEP/MP influence scoring, legislative-pipeline forecasting — that previously required well-funded lobbying organisations or in-house policy units to generate. "Democratising access to political intelligence — what used to require a team of analysts can now be done by any citizen with an AI assistant." The portfolio is non-partisan, fully open-source Apache-2.0 , operated under the Hack23 ISMS https://github.com/Hack23/ISMS-PUBLIC with full ISO 27001:2022 / NIST CSF 2.0 / CIS Controls v8.1 alignment, GDPR-by-design, and architecturally engineered so it cannot be weaponised for partisan influence: equal treatment of all political groups, public-data only, no user accounts, no ads, no tracking. %%{init: {"theme":"base","themeVariables":{"primaryColor":" 6366f1","primaryTextColor":" fff","primaryBorderColor":" 4f46e5","lineColor":" 94a3b8","secondaryColor":" 003399","tertiaryColor":" 00338d","background":" 0f172a"}}}%% graph LR subgraph SOURCES "📡 Primary Open-Data Sources" EP "🇪🇺 European Parliament<br/ Open Data Portal v2<br/ <i data.europarl.europa.eu</i " RD "🇸🇪 Riksdagen Open Data<br/ <i data.riksdagen.se</i " REG "🇸🇪 Regeringskansliet<br/ <i regeringen.se</i " IMF "💰 IMF / World Bank<br/ <i economic context</i " end subgraph MCP "🔌 MCP Servers" EPMCP "<b European-Parliament-<br/ MCP-Server</b <br/ 63 tools · 9 resources<br/ 7 prompts · TS strict<br/ <i this repository </i " RRMCP "riksdag-regering MCP<br/ 32+ tools" end subgraph PRODUCTS "📰 AI-Driven Public Platforms" EUPM "🏛️ <b EU Parliament Monitor</b <br/ euparliamentmonitor.com<br/ 8 unified gh-aw workflows<br/ 51-artifact analysis<br/ 14 languages" RM "🗳️ <b Riksdagsmonitor</b <br/ riksdagsmonitor.com<br/ 11 agentic workflows<br/ 91 skills · 14 languages<br/ Tidö coalition tracker" CIA "🕵️ <b Citizen Intelligence<br/ Agency CIA </b <br/ Java/Spring backend<br/ 15 subsystems · 1971–2024<br/ 3.5M votes · 109K docs" end subgraph CITIZENS "👥 Citizens · Journalists · Researchers · NGOs" AUDIENCE "AI assistants · Dashboards · 14-language news · Intelligence briefings" end EP -- EPMCP RD -- RRMCP REG -- RRMCP EPMCP -- EUPM RRMCP -- RM RM <-- |"15 CIA subsystems<br/ nightly sync"| CIA IMF -.- |"economic context"| EUPM IMF -.- |"economic context"| RM EUPM -- AUDIENCE RM -- AUDIENCE CIA -- AUDIENCE EPMCP -.- |"AI assistants<br/ Claude · Cursor · VS Code"| AUDIENCE style EPMCP fill: 6366f1,stroke: 4f46e5,color: fff,stroke-width:3px style EP fill: 003399,stroke: ffcc00,color: fff style RD fill: 00338d,stroke: fecc00,color: fff style REG fill: 00338d,stroke: fecc00,color: fff style EUPM fill: 003399,stroke: ffcc00,color: fff style RM fill: 00338d,stroke: fecc00,color: fff style CIA fill: 1b5e20,stroke: 43a047,color: fff style AUDIENCE fill: 7b1fa2,stroke: 9c27b0,color: fff This MCP server's role: the canonical, type-safe TypeScript bridge between the European Parliament Open Data Portal and any MCP-aware AI client Claude Desktop, VS Code, Cursor, GitHub Copilot — and the upstream data layer that powers the EU Parliament Monitor newsroom. Every tool is Zod-validated, audit-logged, GDPR-aware, and SLSA Level 3 attested. | Project | Scope | Audience | Links | |---|---|---|---| 🇪🇺 European-Parliament-MCP-Server this repo | EU Parliament data layer for AI agents62 MCP tools · 9 resources · 7 prompts · OSINT analyticsSource: | Developers · AI assistants · Journalists · Researchers | 📦 npm | 💻 GitHub https://github.com/Hack23/European-Parliament-MCP-Server EU Parliament Monitor 8 unified gh-aw workflows · 51-artifact analysis pipeline Source: this MCP server 60+ tools + IMF + World Bank euparliamentmonitor.com 🧠 Intelligence Hub https://euparliamentmonitor.com/political-intelligence.html 📚 API Reference https://euparliamentmonitor.com/docs/api/ 💻 GitHub https://github.com/Hack23/euparliamentmonitor Riksdagsmonitor 11 agentic workflows · 91 skills · 50+ years of evidence 1971–2024 · Tidö coalition fragility tracker Source: riksdag-regering MCP 32+ tools + SCB + IMF + World Bank + CIA exports riksdagsmonitor.com 🧠 Intelligence https://riksdagsmonitor.com/political-intelligence.html 📰 AI Newsroom https://riksdagsmonitor.com/news/index.html 📊 Dashboard https://riksdagsmonitor.com/dashboard/index.html 💻 GitHub https://github.com/Hack23/riksdagsmonitor Citizen Intelligence Agency CIA 349 current MPs · 2,494 historical politicians · 3.5M+ votes · 109k+ documents · 45-rule risk engine Source: data.riksdagen.se direct + Valmyndigheten + ESV hack23.github.io/cia 💻 GitHub https://github.com/Hack23/cia European Parliament Political Intelligence Platform—🧠 Political intelligence · 🔍 Radical transparency · 🗳️ Democratic accountability · 🤖 AI-generated news in 14 languages | | EU Parliament Monitor turns the EP's own open data into auditable political intelligence — and publishes it as readable news in 14 languages, every day, fully sourced. An AI-driven newsroom that monitors plenary sessions, committee work, motions, propositions, urgency files and the forward calendar; produces Economist-style analytical articles backed by 51 structured analysis artifacts per run; and exposes every methodology, template and analysis tree publicly so any reader, journalist or NGO can verify the analysis behind the prose. Powered by this repository — consumes the European-Parliament-MCP-Server 60+ EP data tools plus IMF + World Bank for economic context, with built-in fallback to the EP Open Data Portal /api/v2/decision endpoint when MCP returns empty voting payloads. - 📰 9 unified — 8 article types gh-aw https://github.com/githubnext/gh-aw GitHub Agentic Workflows pipelines breaking , week-ahead , month-ahead , week-in-review , month-in-review , committee-reports , motions , propositions running Stages A → E in a single 45-minute session, plus news-translate for 14-language flush translation - 📚 17 published methodologies + 52 analysis templates + 19 tradecraft references — ICD-203 Key Judgments · Admiralty source grades · WEP probability bands · ACH · 5-framework political-threat model · 6-dimension threat landscape · electoral domain methodology 361-seat threshold · IMF/World Bank indicator mappings - 🌍 14 languages — EN · SV · DA · NO · FI · DE · FR · ES · NL · AR RTL · HE RTL · JA · KO · ZH — every page rendered with WCAG 2.1 AA accessibility, JSON-LD NewsArticle.isBasedOn provenance linking back to source artifacts, and hreflang alternates on every page - 🛡️ Deterministic aggregator — agents author analysis Markdown only; TypeScript renders HTML deterministically no AI-authored HTML, no template-prose leakage, fully reproducible - 📦 npm package — published with euparliamentmonitor npm provenance https://docs.npmjs.com/generating-provenance-statements and SLSA Level 3 build attestations Swedish Political Intelligence Platform—🕵️ Political intelligence · 🔍 Democratic transparency · 🤖 AI-generated news · 📊 50+ years of evidence | | Riksdagsmonitor monitors Sweden's Riksdag Parliament , the Government Regeringskansliet and public agencies Myndigheter with structured intelligence techniques — ACH, SWOT, PESTLE, STRIDE, political-risk scoring and OSINT/INTOP tradecraft — applied to 349 current MPs , 2,494 historical politicians 1971–2024 , 3.5M+ votes and 109,000+ parliamentary documents . An autonomous AI newsroom — 11 agentic workflows , Claude Opus, zero human editors — turns this evidence into publication-ready intelligence articles in 14 languages, every day . Front-loads the live Tidö Agreement coalition status 176/349 seats, fragility indicators, CIA risk alerts and dives into 40 years of election-cycle intelligence 1994–2034 , party performance 1990–2026, 8 parties , 15 committee networks, seasonal Z-score anomaly detection, ministry risk and a 45-rule × 349-MP live risk heat map. - 📰 11 agentic workflows — committee reports · propositions · motions · interpellations · week-ahead · month-ahead · real-time monitor · evening analysis · weekly review · monthly review · translate Mon–Fri + weekend cycles, all on UTC schedules - 🧠 91 skills across 12 categories + 24 Copilot agents 14 personas + 9 workflow specialists + shared developer instructions — full catalog at SKILLS.md https://github.com/Hack23/riksdagsmonitor/blob/main/SKILLS.md / AGENTS.md https://github.com/Hack23/riksdagsmonitor/blob/main/AGENTS.md - 📚 11 published methodologies + 23 templates 8 core T1–T8 + 15 extended/Tier-C — AI-Driven Analysis Guide · OSINT Tradecraft Standards · Political Risk · Political SWOT · Political Threat Framework · Electoral Domain · Synthesis · Strategic Extensions scenario / wildcard / long-horizon · Style Guide - 📊 5 flagship Chart.js / D3.js dashboards + CIA Intelligence Dashboard https://riksdagsmonitor.com/dashboard/index.html — Seasonal Activity 2002–2025 · Z-score anomaly · 349-MP Politician Dashboard · Pre-Election Monitor · Party Performance 1990–2026 · Anomaly & Early Warning - 🌍 14 languages — EN · SV · DA · NO · FI · DE · FR · ES · NL · AR RTL · HE RTL · JA · KO · ZH — daily refresh at 03:00 CET, WCAG 2.1 AA, CSP-hardened with Subresource Integrity SRI on all bundled assets - 📦 npm package — Theme System · Chart Factory · Resilient Data Loader · 12 dashboard modules · CIA intelligence modules — published with SLSA build provenance riksdagsmonitor - 🛡️ OpenSSF Best Practices Project 12069 · Risk level 🟢 LOW 5.52 / 10.0 — 99.7 % risk reduction · ISO 27001:2022 · NIST CSF 2.0 · CIS Controls v8.1 · GDPR Art. 9 2 e/g for political opinions Political transparency platform— Java/Spring data backbone behind Riksdagsmonitor's historical evidence layer | Dimension | Coverage | |---|---| 🌐 Languages | 14 — English · Swedish · Danish · Norwegian · Finnish · German · French · Spanish · Dutch · Arabic RTL · Hebrew RTL · Japanese · Korean · Chinese | ♿ Accessibility | WCAG 2.1 AA · keyboard navigable · screen-reader optimised · 4.5:1 contrast · responsive 320 px → 1440 px+ | 🔒 Compliance | ISO 27001:2022 · NIST CSF 2.0 · CIS Controls v8.1 · GDPR · NIS2 · EU CRA | 🛡️ Supply chain | SHA-pinned GitHub Actions · step-security/harden-runner · Dependabot · CodeQL · Secret Scanning · SLSA Level 3 · SPDX SBOM | 📜 License | Apache License 2.0 across the entire portfolio | 🏢 Operator | | ISMS Hack23 ISMS-PUBLIC https://github.com/Hack23/ISMS-PUBLIC — fully documented information-security management system- 🌐 Live platforms — euparliamentmonitor.com https://euparliamentmonitor.com · riksdagsmonitor.com https://riksdagsmonitor.com · hack23.github.io/cia https://hack23.github.io/cia/ · hack23.com https://hack23.com - 🧠 Political Intelligence Hubs — EU Parliament https://euparliamentmonitor.com/political-intelligence.html · Riksdag https://riksdagsmonitor.com/political-intelligence.html - 📂 Source repositories — European-Parliament-MCP-Server https://github.com/Hack23/European-Parliament-MCP-Server · euparliamentmonitor https://github.com/Hack23/euparliamentmonitor · riksdagsmonitor https://github.com/Hack23/riksdagsmonitor · cia https://github.com/Hack23/cia · ISMS-PUBLIC https://github.com/Hack23/ISMS-PUBLIC - 📦 npm packages —· european-parliament-mcp-server · euparliamentmonitor riksdagsmonitor - 📰 Blog & company — Hack23 blog https://hack23.com/blog.html · LinkedIn — Hack23 AB https://www.linkedin.com/company/hack23/ · founder James Pether Sörling, CISSP, CISM https://www.linkedin.com/in/jamessorling/ - 🤖 AI-readable wikis — DeepWiki: European-Parliament-MCP-Server https://deepwiki.com/Hack23/European-Parliament-MCP-Server · DeepWiki: euparliamentmonitor https://deepwiki.com/Hack23/euparliamentmonitor · DeepWiki: riksdagsmonitor https://deepwiki.com/Hack23/riksdagsmonitor · DeepWiki: cia https://deepwiki.com/Hack23/cia npx -y european-parliament-mcp-server - Node.js 26.x or higher - npm 10.x or higher Install the package globally npm install -g european-parliament-mcp-server Or install as a dependency in your project npm install european-parliament-mcp-server Clone the repository git clone https://github.com/Hack23/European-Parliament-MCP-Server.git cd European-Parliament-MCP-Server Install dependencies npm install Build the project npm run build Run tests npm test Add to your claude desktop config.json : { "mcpServers": { "european-parliament": { "command": "npx", "args": "european-parliament-mcp-server" , "env": { "EP API KEY": "your-api-key-if-needed" } } } } Add to your claude desktop config.json : { "mcpServers": { "european-parliament": { "command": "node", "args": "/path/to/European-Parliament-MCP-Server/dist/index.js" , "env": { "EP API KEY": "your-api-key-if-needed" } } } } Configure in .vscode/mcp.json : { "servers": { "european-parliament": { "type": "stdio", "command": "npx", "args": "-y", "european-parliament-mcp-server" } } } Add to ~/.cursor/mcp.json or project-level .cursor/mcp.json : { "mcpServers": { "european-parliament": { "command": "npx", "args": "european-parliament-mcp-server" , "env": {} } } } Use --timeout <ms to override the default 60 s request timeout. This is especially useful in copilot-mcp.json or other contexts where the env field may not reliably propagate: { "args": "european-parliament-mcp-server", "--timeout", "90000" } Precedence: --timeout CLI arg EP REQUEST TIMEOUT MS env var default 60 000 ms . Note:The procedures/feed and events/feed endpoints automatically use an extended 120 s timeout because these EP API endpoints are significantly slower than others. If you experience timeouts with one-month timeframes, consider using year-based queries e.g., get procedures { year: 2026 } as a faster alternative. 📖 Complete Documentation Site - Live documentation portal with: - 📖 - TypeDoc generated API documentation with search, hierarchy navigation, and full type information API Reference HTML https://hack23.github.io/European-Parliament-MCP-Server/api/ - 📖 - SEO-friendly Markdown API documentation API Reference Markdown https://hack23.github.io/European-Parliament-MCP-Server/api-markdown/ - 📊 - Test coverage analysis Coverage Reports https://hack23.github.io/European-Parliament-MCP-Server/coverage/ - ✅ - Unit and E2E test results Test Reports https://hack23.github.io/European-Parliament-MCP-Server/test-results/ - 🔐 Build Attestations - SLSA Level 3 provenance - 📦 SBOM - Software Bill of Materials - 🗺️ - Auto-generated sitemap for search engines Sitemap https://hack23.github.io/European-Parliament-MCP-Server/api/sitemap.xml 💡 Note: Documentation is automatically generated and committed with each release via npm run docs:build The API documentation is generated using TypeDoc https://typedoc.org/ with the following plugins: | Plugin | Purpose | |---|---| typedoc | Core HTML documentation generator | typedoc-plugin-markdown | Generates SEO-friendly Markdown alongside HTML | typedoc-plugin-mdn-links | Links TypeScript built-in types to MDN documentation | typedoc-plugin-zod | Renders Zod schema definitions as readable type documentation | Generate documentation locally: npm run docs HTML API docs → docs/api/ npm run docs:md Markdown API docs → docs/api-markdown/ npm run docs:build Full documentation build HTML + MD + coverage + test reports - Complete tool documentation with examples API Usage Guide - C4 model diagrams and data flows Architecture Diagrams - Common issues and solutions Troubleshooting Guide - Development workflow and contributing Developer Guide - Claude Desktop, VS Code, Docker setup Deployment Guide - Optimization strategies Performance Guide - How documentation is generated Documentation as Code Guide - Complete architecture and design documentation ARCHITECTURE.md - Security policy and vulnerability disclosure SECURITY.md - API security headers implementation SECURITY HEADERS.md - Software Bill of Materials documentation docs/SBOM.md - Contribution guidelines CONTRIBUTING.md - Community code of conduct CODE OF CONDUCT.md - Development guidelines for GitHub Copilot .github/copilot-instructions.md - Custom GitHub Copilot agents .github/agents/README.md - Reusable skill patterns .github/skills/README.md php graph TB Client MCP Client<br/ Claude / VS Code / Cursor -- |MCP Protocol stdio| Server EP MCP Server<br/ TypeScript/Node.js subgraph "MCP Server src/ " direction TB Tools "🔧 61 Tools<br/ getMEPs · analyzeCoalition<br/ assessMepInfluence · …" Resources "📦 9 Resources<br/ ep://meps/\{mepId\}<br/ ep://procedures/\{procedureId\} · …" Prompts "💬 7 Prompts<br/ mep briefing<br/ coalition analysis · …" end Server -- Tools Server -- Resources Server -- Prompts subgraph "Infrastructure" Cache "LRU Cache<br/ 500 entries · 15 min TTL" RateLimiter Rate Limiter<br/ 100 req/min AuditLog Audit Logger<br/ GDPR Article 30 end Tools -- EPClient "EuropeanParliamentClient<br/ Facade → 8 sub-clients" Resources -- EPClient EPClient -- Cache EPClient -- RateLimiter EPClient -- AuditLog EPClient -- |HTTPS/TLS 1.3| EPAPI European Parliament<br/ Open Data API v2<br/ data.europarl.europa.eu style Server fill: 4caf50,stroke: 2e7d32,color: fff style EPClient fill: 2196f3,stroke: 1565c0,color: fff style EPAPI fill: 9c27b0,stroke: 6a1b9a,color: fff style Cache fill: ff9800,stroke: e65100,color: fff style RateLimiter fill: f44336,stroke: b71c1c,color: fff style AuditLog fill: 607d8b,stroke: 37474f,color: fff Data flow: MCP client sends a tool call → server validates input Zod → EP client checks cache → on miss, fetches from EP API rate-limited → response cached and returned as structured JSON. All personal data access is audit-logged per GDPR Article 30. 63 tools organized by capability — OSINT intelligence first, then analytical, data access, feed endpoints, and reference tools. Every tool includes Zod input validation, caching, and rate limiting. graph TB subgraph OSINT "🕵️ OSINT Intelligence — 15 Tools" direction LR subgraph MEP "MEP Profiling" A1 "assess mep influence" A2 "comparative intelligence" A3 "network analysis" A4 "track mep attendance" end subgraph COALITION "Coalition Dynamics" B1 "analyze coalition dynamics" B2 "compare political groups" B3 "detect voting anomalies" B4 "sentiment tracker" end subgraph STRATEGY "Strategic Warning" C1 "early warning system" C2 "generate political landscape" C3 "correlate intelligence" end subgraph LEG INTEL "Legislative Intelligence" D1 "analyze legislative effectiveness" D2 "monitor legislative pipeline" D3 "analyze committee activity" D4 "analyze country delegation" end end subgraph ANALYTICS "📊 Advanced Analysis — 4 Tools" E1 "analyze voting patterns" E2 "track legislation" E3 "generate report" E4 "get all generated stats" end subgraph DATA "📦 Core EP Data — 30 Tools" F1 "👤 MEP Tools 7 " F2 "🏛️ Plenary & Meeting 9 " F3 "📄 Document Tools 7 " F4 "⚖️ Legislative 4 " F5 "🏢 Committee 2 " F6 "🔧 Diagnostics 1 " end subgraph FEEDS "📡 Real-Time Feeds — 13 Tools" G1 "13 change monitoring endpoints" end OSINT -- |"enriched by"| ANALYTICS ANALYTICS -- |"queries"| DATA DATA -- |"monitors"| FEEDS style OSINT fill: d32f2f,stroke: b71c1c,color: fff,stroke-width:2px style ANALYTICS fill: 1565c0,stroke: 0d47a1,color: fff,stroke-width:2px style DATA fill: 2e7d32,stroke: 1b5e20,color: fff,stroke-width:2px style FEEDS fill: ff8f00,stroke: e65100,color: 000,stroke-width:2px style MEP fill: e53935,stroke: c62828,color: fff,stroke-width:2px style COALITION fill: e53935,stroke: c62828,color: fff,stroke-width:2px style STRATEGY fill: e53935,stroke: c62828,color: fff,stroke-width:2px style LEG INTEL fill: e53935,stroke: c62828,color: fff,stroke-width:2px graph LR subgraph COLLECT "1️⃣ Collect" direction TB C1 "get meps" C2 "get plenary sessions" C3 "get voting records" C4 "get procedures" C5 "13 feed tools" end subgraph ANALYZE "2️⃣ Analyze" direction TB AN1 "analyze voting patterns" AN2 "track legislation" AN3 "generate report" AN4 "get all generated stats" end subgraph ENRICH "3️⃣ Enrich" direction TB E1 "assess mep influence" E2 "analyze coalition dynamics" E3 "detect voting anomalies" E4 "network analysis" E5 "analyze legislative effectiveness" end subgraph FUSE "4️⃣ Fuse & Alert" direction TB F1 "correlate intelligence" F2 "early warning system" F3 "generate political landscape" F4 "comparative intelligence" F5 "sentiment tracker" end COLLECT -- |"raw data"| ANALYZE ANALYZE -- |"structured"| ENRICH ENRICH -- |"intelligence"| FUSE style COLLECT fill: 2e7d32,stroke: 1b5e20,color: fff,stroke-width:2px style ANALYZE fill: 1565c0,stroke: 0d47a1,color: fff,stroke-width:2px style ENRICH fill: 9c27b0,stroke: 7b1fa2,color: fff,stroke-width:2px style FUSE fill: d32f2f,stroke: b71c1c,color: fff,stroke-width:2px | Tool | Description | Key Parameters | Output | |---|---|---|---| correlate intelligence | assess mep influence detect voting anomalies analyze coalition dynamics early warning system comparative intelligence network analysis sentiment tracker generate political landscape compare political groups analyze legislative effectiveness monitor legislative pipeline analyze committee activity track mep attendance analyze country delegation | Tool | Description | Key Parameters | Output | |---|---|---|---| get all generated stats | 30 OSINT-derived intelligence metrics /Hack23/European-Parliament-MCP-Server/blob/main/EP POLITICAL LANDSCAPE.md including 3-axis political compass analyze voting patterns track legislation generate report | Tool | Description | Key Parameters | EP API Endpoint | |---|---|---|---| get meps | GET /meps get mep details GET /meps/{id} get current meps GET /meps/show-current get incoming meps GET /meps/show-incoming get outgoing meps GET /meps/show-outgoing get homonym meps GET /meps/show-homonyms get mep declarations GET /meps-declarations , GET /meps-declarations/{id} | Tool | Description | Key Parameters | EP API Endpoint | |---|---|---|---| get plenary sessions | GET /meetings , GET /meetings/{id} get voting records GET /meetings/{id}/vote-results get speeches GET /speeches , GET /speeches/{id} get events GET /events , GET /events/{id} get meeting activities GET /meetings/{id}/activities get meeting decisions GET /meetings/{id}/decisions get meeting foreseen activities GET /meetings/{id}/foreseen-activities get meeting plenary session documents GET /meetings/{id}/plenary-session-documents get meeting plenary session document items GET /meetings/{id}/plenary-session-document-items | Tool | Description | Key Parameters | EP API Endpoint | |---|---|---|---| get committee info | GET /corporate-bodies , GET /corporate-bodies/show-current get committee documents GET /committee-documents , GET /committee-documents/{id} | Tool | Description | Key Parameters | EP API Endpoint | |---|---|---|---| search documents | GET /documents , GET /documents/{id} get adopted texts GET /adopted-texts , GET /adopted-texts/{id} get plenary documents GET /plenary-documents , GET /plenary-documents/{id} get plenary session documents GET /plenary-session-documents , GET /plenary-session-documents/{id} get plenary session document items GET /plenary-session-documents-items get external documents GET /external-documents , GET /external-documents/{id} get parliamentary questions GET /parliamentary-questions , GET /parliamentary-questions/{id} | Tool | Description | Key Parameters | EP API Endpoint | |---|---|---|---| get procedures | GET /procedures , GET /procedures/{id} get procedure events GET /procedures/{id}/events get procedure event by id GET /procedures/{id}/events/{event-id} get controlled vocabularies GET /controlled-vocabularies , GET /controlled-vocabularies/{id} Real-time change feeds for monitoring recently updated data across all EP API categories. Per the EP OpenAPI spec /Hack23/European-Parliament-MCP-Server/blob/main/docs/ep-openapi-spec.json , feeds fall into two groups: Configurable-window 6 tools : Accept timeframe today , one-day , one-week , one-month , custom + optional startDate Fixed-window 7 tools : No parameters — return updates from a server-defined default window typically one month Key behaviors: - All feeds return JSON-LD with data , @context , and dataQualityWarnings - Empty feeds EP API 404 or error-in-body are converted to empty data with a warning — not errors get events feed and get procedures feed always use a minimum 120s timeout because these endpoints are consistently slow- Fixed-window feeds can be very slow 30–180 s and often return error-in-body responses - For configurable feeds, when timeframe is custom , startDate YYYY-MM-DD is required Configurable-window feeds: | Tool | Description | Key Parameters | EP API Endpoint | |---|---|---|---| get meps feed | GET /meps/feed get events feed GET /events/feed get procedures feed GET /procedures/feed get adopted texts feed GET /adopted-texts/feed get mep declarations feed GET /meps-declarations/feed get external documents feed GET /external-documents/feed Fixed-window feeds no parameters : | Tool | Description | Key Parameters | EP API Endpoint | |---|---|---|---| get documents feed | none GET /documents/feed get plenary documents feed none GET /plenary-documents/feed get committee documents feed none GET /committee-documents/feed get plenary session documents feed none GET /plenary-session-documents/feed get parliamentary questions feed none GET /parliamentary-questions/feed get corporate bodies feed none GET /corporate-bodies/feed get controlled vocabularies feed none GET /controlled-vocabularies/feed | Tool | Description | Key Parameters | Output | |---|---|---|---| get server health | none 📖 Complete TypeDoc API documentation → · Markdown API docs → https://hack23.github.io/European-Parliament-MCP-Server/api-markdown/ Research a specific MEP : 1. Find MEP: get meps → {country: "SE"} 2. Get details: get mep details → {id: "MEP-123"} 3. Analyze voting: analyze voting patterns → {mepId: "MEP-123"} 4. Generate report: generate report → {reportType: "MEP ACTIVITY", subjectId: "MEP-123"} Track legislation : 1. Search documents: search documents → {keywords: "climate change"} 2. Track procedure: track legislation → {procedureId: "2024/0001 COD "} 3. Get voting records: get voting records → {topic: "climate"} Committee analysis : 1. Get committee: get committee info → {abbreviation: "ENVI"} 2. List members: get meps → {committee: "ENVI"} 3. Generate report: generate report → {reportType: "COMMITTEE PERFORMANCE", subjectId: "COMM-ENVI"} OSINT Intelligence analysis : 1. Score MEP influence: assess mep influence → {mepId: "MEP-123"} 2. Detect anomalies: detect voting anomalies → {mepId: "MEP-123"} 3. Analyze coalitions: analyze coalition dynamics → {groupIds: "EPP", "S&D" } 4. Compare groups: compare political groups → {groupIds: "EPP", "S&D", "Renew" } 5. Pipeline status: monitor legislative pipeline → {committee: "ENVI"} 6. Country delegation: analyze country delegation → {country: "SE"} 7. Political landscape: generate political landscape → {} 🎯 More use cases and examples → /Hack23/European-Parliament-MCP-Server/blob/main/API USAGE GUIDE.md common-use-cases Pre-built intelligence analysis prompt templates: | Prompt | Description | Arguments | |---|---|---| mep briefing | Comprehensive MEP intelligence briefing | mepId required , period? | coalition analysis | Coalition dynamics and voting bloc analysis | policyArea?, period? | legislative tracking | Legislative procedure tracking report | procedureId?, committee? | political group comparison | Multi-dimensional group comparison | groups? | committee activity report | Committee workload and engagement | committeeId required | voting pattern analysis | Voting pattern trend detection | topic?, mepId? | country delegation analysis | Country delegation composition and activity | country required , period? | Direct data access via EP resource URIs: | Resource URI | Description | |---|---| ep://meps | List of all current MEPs | ep://meps/{mepId} | Individual MEP profile | ep://committees/{committeeId} | Committee information | ep://plenary-sessions | Recent plenary sessions | ep://votes/{sessionId} | Voting records for a session | ep://political-groups | Political group listing | ep://procedures/{procedureId} | Legislative procedure details | ep://plenary/{plenaryId} | Single plenary session details | ep://documents/{documentId} | Legislative document details | The European Parliament MCP Server is part of a growing ecosystem of political and government open data MCP servers enabling AI-powered OSINT analysis of democratic institutions worldwide. Below is the most comprehensive directory of political and government MCP servers available. | Country | Server | Data Source | Coverage | |---|---|---|---| 🇪🇺 European Union | European Parliament MCP Server | 63 tools 15 OSINT United States Congress.gov API MCP Server https://github.com/bsmi021/mcp-congress gov server United States CongressMCP https://github.com/amurshak/congressMCP United States Congress.gov MCP https://github.com/AshwinSundar/congress gov mcp United Kingdom Parliament MCP https://github.com/i-dot-ai/parliament-mcp Sweden Riksdag & Regering MCP https://github.com/isakskogstad/Riksdag-Regering-MCP riksdagsmonitor.com https://riksdagsmonitor.com/ Netherlands OpenTK MCP https://github.com/r-huijts/opentk-mcp Poland Parliament of Poland MCP https://github.com/pkolawa/parliament-poland-mcp-server Poland Sejm MCP https://github.com/janisz/sejm-mcp Israel Knesset MCP Server https://github.com/zohar/knesset-mcp Brazil Senado BR MCP https://mcpservers.org/servers/sidneybissoli/senado-br-mcp | Country | Server | Data Source | Coverage | |---|---|---|---| 🇺🇸 United States | | United States Open Census MCP https://mcpservers.org/servers/brockwebb/open-census-mcp-server United States Data.gov MCP Server https://github.com/melaodoidao/datagov-mcp-server United States CMS Data.gov MCP https://github.com/clarifyhealth/cms-datagov-mcp-server United States SEC EDGAR MCP https://github.com/stefanoamorelli/sec-edgar-mcp United States NPS MCP https://github.com/amysatterlee/nps mcp Sweden SCB MCP Server https://mcpservers.org/servers/isakskogstad/scb-mcp Sweden Skolverket MCP https://mcpservers.org/servers/ksaklfszf921/skolverket-mcp France data.gouv.fr MCP https://github.com/datagouv/datagouv-mcp France Data Gouv MCP Server https://mcpservers.org/servers/csonigo/datagouv-mcp-server United Kingdom Planning Data MCP https://github.com/alizoli/planningdatagovuk-api United Kingdom Property Prices MCP https://github.com/joemclo/property-prices-mcp Netherlands CBS Open Data MCP https://github.com/dstotijn/mcp-cbs-cijfers-open-data Israel Data.gov.il MCP https://github.com/DavidOsherProceed/data-gov-il-mcp Israel DataGov Israel MCP https://github.com/aviveldan/datagov-mcp Israel Israel Statistics MCP https://github.com/reuvenaor/israel-statistics-mcp Israel BudgetKey MCP https://github.com/OpenBudget/budgetkey-mcp Turkey Mevzuat MCP https://mcpservers.org/servers/MCP-Mirror/saidsurucu mevzuat-mcp Hong Kong HK Data.gov.hk MCP https://github.com/hkopenai/hk-datagovhk-mcp-server Malaysia Data.gov.my MCP https://github.com/manfye/data-dosm-mcp-nodejs India Data.gov.in MCP https://github.com/adwait-ai/mcp data gov in Singapore Gahmen MCP Server https://github.com/aniruddha-adhikary/gahmen-mcp Singapore Singapore Data MCPs https://github.com/prezgamer/Singapore-Data-MCPs Australia ABS MCP Server https://github.com/seansoreilly/mcp-server-abs | Scope | Server | Platform | Coverage | |---|---|---|---| 🌐 Global CKAN | | Global Socrata OpenGov MCP Server https://github.com/srobbin/opengov-mcp-server | Capability | 🇪🇺 EU Parliament MCP | 🇺🇸 Congress.gov MCP | 🇬🇧 UK Parliament MCP | 🇸🇪 Riksdag MCP | |---|---|---|---|---| | Member profiling | ✅ 5-dimension influence model | ✅ Basic profiles | ✅ Basic profiles | ✅ Basic profiles | | Voting analysis | ✅ Anomaly detection + patterns | ✅ Roll call votes | ✅ Division records | ✅ Vote records | | Coalition dynamics | ✅ Cohesion & stress analysis | ❌ | ❌ | ❌ | | Committee intelligence | ✅ Workload & engagement metrics | ✅ Committee data | ✅ Committee data | ❌ | | Legislative pipeline | ✅ Bottleneck detection + forecasting | ✅ Bill tracking | ✅ Bill tracking | ✅ Bill tracking | | Country delegation analysis | ✅ National cohesion metrics | N/A | N/A | N/A | | Political landscape | ✅ Parliament-wide situational awareness | ❌ | ❌ | ❌ | | Attendance tracking | ✅ Trend detection + engagement scoring | ❌ | ❌ | ❌ | | GDPR compliance | ✅ Privacy-first design | N/A | N/A | ✅ | | MCP prompts & resources | ✅ 7 prompts + 9 resources | ❌ | ❌ | ❌ | | Tool count | 63 tools | ~5 tools | ~5 tools | ~4 tools | 💡 The European Parliament MCP Server offers the most comprehensive OSINT intelligence capabilitiesof any political MCP server, with63 specialized toolsincluding advanced analytics like coalition stress analysis, voting anomaly detection, cross-tool intelligence correlation, political landscape generation, and precomputed longitudinal statistics. It is the only political MCP server with built-in MCP prompts, resources, and a 5-dimension MEP influence scoring model. All 55 European Parliament Open Data API v2 https://data.europarl.europa.eu/en/developer-corner/opendata-api endpoints are fully covered — 41 core data endpoints, 13 feed endpoints, and 1 optional endpoint /procedures/{id}/events/{event-id} : | Category | Endpoints | MCP Tools | |---|---|---| MEPs | /meps , /meps/{id} , /meps/show-current , /meps/show-incoming , /meps/show-outgoing , /meps/show-homonyms | get meps , get mep details , get current meps , get incoming meps , get outgoing meps , get homonym meps | MEP Documents | /meps-declarations , /meps-declarations/{id} | get mep declarations | Corporate Bodies | /corporate-bodies , /corporate-bodies/{id} , /corporate-bodies/show-current | get committee info | Events | /events , /events/{id} | get events | Meetings | /meetings , /meetings/{id} , /meetings/{id}/activities , /meetings/{id}/decisions , /meetings/{id}/foreseen-activities , /meetings/{id}/vote-results , /meetings/{id}/plenary-session-documents , /meetings/{id}/plenary-session-document-items | get plenary sessions , get meeting activities , get meeting decisions , get meeting foreseen activities , get voting records , get meeting plenary session documents , get meeting plenary session document items | Speeches | /speeches , /speeches/{id} | get speeches | Procedures | /procedures , /procedures/{id} , /procedures/{id}/events , /procedures/{id}/events/{event-id} | get procedures , get procedure events , get procedure event by id | Documents | /documents , /documents/{id} , /adopted-texts , /adopted-texts/{id} , /committee-documents , /committee-documents/{id} , /plenary-documents , /plenary-documents/{id} , /plenary-session-documents , /plenary-session-documents/{id} , /plenary-session-documents-items | search documents , get adopted texts , get committee documents , get plenary documents , get plenary session documents , get plenary session document items | Questions | /parliamentary-questions , /parliamentary-questions/{id} | get parliamentary questions | External Documents | /external-documents , /external-documents/{id} | get external documents | Vocabularies | /controlled-vocabularies , /controlled-vocabularies/{id} | get controlled vocabularies | Feed Endpoints | /meps/feed , /events/feed , /procedures/feed , /adopted-texts/feed , /meps-declarations/feed , /documents/feed , /plenary-documents/feed , /committee-documents/feed , /plenary-session-documents/feed , /external-documents/feed , /parliamentary-questions/feed , /corporate-bodies/feed , /controlled-vocabularies/feed | get meps feed , get events feed , get procedures feed , get adopted texts feed , get mep declarations feed , get documents feed , get plenary documents feed , get committee documents feed , get plenary session documents feed , get external documents feed , get parliamentary questions feed , get corporate bodies feed , get controlled vocabularies feed | API : https://data.europarl.europa.eu/api/v2/ https://data.europarl.europa.eu/api/v2/ Documentation : https://data.europarl.europa.eu/en/developer-corner https://data.europarl.europa.eu/en/developer-corner Format : JSON-LD, RDF/XML, Turtle License : European Parliament Open Data License This project aligns with Hack23 AB's Information Security Management System ISMS https://github.com/Hack23/ISMS-PUBLIC : - ✅ ISO 27001:2022 - Information security management - ✅ NIST CSF 2.0 - Cybersecurity framework - ✅ CIS Controls v8.1 - Security best practices - ✅ GDPR - EU data protection compliance - 🔐 Authentication : API key + OAuth 2.0 planned - 🛡️ Input Validation : Zod schemas for all inputs - ⚡ Rate Limiting : 100 requests per minute - 🔒 Security Headers : CSP, HSTS, X-Frame-Options, etc. - 📝 Audit Logging : All data access logged - 🔍 Vulnerability Scanning : CodeQL, Dependabot, OSSF Scorecard This project achieves SLSA Level 3 compliance: - ✅ Build Provenance - Cryptographic proof of build integrity - ✅ Attestations - All artifacts cryptographically signed - ✅ Verification - gh attestation verify <artifact --owner Hack23 --repo European-Parliament-MCP-Server - ✅ npm Provenance - Published with provenance for package integrity - ✅ SBOM - SPDX-format Software Bill of Materials - ✅ Dependency Review - Automated vulnerability scanning - ✅ License Compliance - Only MIT, Apache-2.0, BSD, ISC allowed See ATTESTATIONS.md /Hack23/European-Parliament-MCP-Server/blob/main/docs/ATTESTATIONS.md for verification instructions and security benefits. Per Hack23 Open Source Policy https://github.com/Hack23/ISMS-PUBLIC/blob/main/Open Source Policy.md : | Property | Value | |---|---| CRA Classification | | Confidentiality Integrity Availability See CRA-ASSESSMENT.md /Hack23/European-Parliament-MCP-Server/blob/main/CRA-ASSESSMENT.md for the full EU Cyber Resilience Act conformity assessment. Install dependencies npm install Run in development mode with auto-reload npm run dev Type checking npm run type-check Linting npm run lint Format code npm run format Run tests npm test Run tests with coverage npm run test:coverage European-Parliament-MCP-Server/ ├── src/ Source code │ ├── server.ts MCP server entry point │ ├── tools/ MCP tool implementations │ ├── resources/ MCP resource handlers │ ├── prompts/ MCP prompt templates │ ├── clients/ European Parliament API client │ ├── schemas/ Zod validation schemas │ ├── types/ TypeScript type definitions │ └── utils/ Utility functions ├── tests/ Test files ├── .github/ GitHub configuration │ ├── agents/ Custom Copilot agents │ ├── skills/ Reusable skill patterns │ └── workflows/ CI/CD workflows └── docs/ Additional documentation - Detailed analysis of JSDoc documentation coverage across all source files JSDoc Coverage Report /Hack23/European-Parliament-MCP-Server/blob/main/JSDOC COVERAGE REPORT.md - Quick reference guide for writing comprehensive JSDoc comments JSDoc Quick Reference /Hack23/European-Parliament-MCP-Server/blob/main/docs/JSDOC QUICK REFERENCE.md - Executive summary of documentation status and priorities JSDoc Coverage Summary /Hack23/European-Parliament-MCP-Server/blob/main/JSDOC COVERAGE SUMMARY.md - Visual representation of documentation coverage with charts and graphs JSDoc Coverage Visualization /Hack23/European-Parliament-MCP-Server/blob/main/docs/JSDOC COVERAGE VISUALIZATION.md - System architecture and design patterns Architecture Documentation /Hack23/European-Parliament-MCP-Server/blob/main/ARCHITECTURE.md - Data structures and type definitions Data Model /Hack23/European-Parliament-MCP-Server/blob/main/DATA MODEL.md - Guide for using the MCP server API API Usage Guide /Hack23/European-Parliament-MCP-Server/blob/main/API USAGE GUIDE.md - 📊 Comprehensive Mermaid visualization of all EP statistics 2004–2026 , political compass, coalition dynamics, and OSINT intelligence metrics — all years validated against EP API v2 EP Political Landscape /Hack23/European-Parliament-MCP-Server/blob/main/EP POLITICAL LANDSCAPE.md - Test coverage statistics and analysis Test Coverage Report /Hack23/European-Parliament-MCP-Server/blob/main/TEST COVERAGE REPORT.md - Development setup and guidelines Developer Guide /Hack23/European-Parliament-MCP-Server/blob/main/DEVELOPER GUIDE.md - Performance optimization strategies Performance Guide /Hack23/European-Parliament-MCP-Server/blob/main/PERFORMANCE GUIDE.md - Vulnerability reporting and security practices Security Policy /Hack23/European-Parliament-MCP-Server/blob/main/SECURITY.md - Security controls and architecture Security Architecture /Hack23/European-Parliament-MCP-Server/blob/main/SECURITY ARCHITECTURE.md - Secure coding standards Secure Development Policy /Hack23/European-Parliament-MCP-Server/blob/main/Secure Development Policy.md - Open source compliance guidelines Open Source Policy /Hack23/European-Parliament-MCP-Server/blob/main/Open Source Policy.md - Production deployment instructions Deployment Guide /Hack23/European-Parliament-MCP-Server/blob/main/DEPLOYMENT GUIDE.md - Common issues and solutions Troubleshooting Guide troubleshooting - Package publishing workflow NPM Publishing Guide /Hack23/European-Parliament-MCP-Server/blob/main/NPM PUBLISHING.md Unit tests npm test Integration tests requires EP INTEGRATION TESTS=true EP INTEGRATION TESTS=true npm run test:integration Integration tests with fixture capture EP INTEGRATION TESTS=true EP SAVE FIXTURES=true npm run test:integration E2E tests npm run test:e2e Coverage report npm run test:coverage Watch mode npm run test:watch Integration Testing : When EP INTEGRATION TESTS=true , the integration test suite validates 46 MCP tools against the real European Parliament API endpoints see INTEGRATION TESTING.md /Hack23/European-Parliament-MCP-Server/blob/main/INTEGRATION TESTING.md for the complete 62-tool coverage guide . All tools return real data — no mock or placeholder data is used. Live API tests are disabled by default to respect rate limits 100 req/min . Lint code npm run lint Fix linting issues npm run lint:fix Check for unused dependencies npm run knip Security audit npm audit License compliance npm run test:licenses Optional: keep Mermaid diagrams readable while editing Mermaid validation is not currently enforced in CI Symptom: Requests return 429 Too Many Requests or slow down unexpectedly. The European Parliament Open Data API enforces rate limits. The MCP server automatically applies a token-bucket rate limiter 100 requests per minute . Solutions: Reduce concurrency — don't call multiple tools in parallel bursts Use the built-in cache — repeated identical requests are served from LRU cache Add a delay between bulk operations: e.g., call get meps, wait 1 s, then call get mep details Check current cache stats if using programmatic access : const stats = epClient.getCacheStats ; console.log Cache hit rate: ${stats.hitRate}%