A
licenseNot graded
qualityD
maintenanceEconomic data MCP server that connects FRED, BLS, BEA, IMF, World Bank, and ECB to any MCP-compatible client, with built-in methodology rules to guide LLMs in selecting appropriate economic indicators.
MIT
eiu-mcp-server
eiu-mcp-server
Ein Model Context Protocol-Server, der Claude (oder einem beliebigen MCP-kompatiblen LLM-Client) strukturierten, token-effizienten Zugriff auf die EIU-Daten-API bietet — rund 200 Länder und 320 Wirtschaftsindikator-Serien, historische Daten und Prognosen.
Er stellt drei Tools bereit:
Tool | Zweck |
| Verfügbare Geografien und Serien auflisten, optional nach Stichwort gefiltert |
| Stichwortsuche im Serienkatalog (z. B. |
| Daten nach Land und Seriencode abrufen, mit Häufigkeits- und Datumsfiltern |
Referenzdaten werden einmal pro Sitzung geladen und im Speicher zwischengespeichert, sodass Durchsuchen und Suchen keine weiteren API-Aufrufe kosten.
Voraussetzungen
Zugang zum EIU API Developer Portal. Die Einrichtung erfolgt nicht im Self-Service. Schreiben Sie an economicssupport@economist.com und bitten Sie um Zugang zum Developer Portal. Ihr Konto wird manuell eingerichtet. Sie benötigen alle drei Angaben: Ihre Portal-E-Mail-Adresse, Ihr Portal-Passwort und den im Portal angezeigten API-Schlüssel.
Auf Ihrem Rechner muss
uvinstalliert sein. Einzeiler:curl -LsSf https://astral.sh/uv/install.sh | sh
Sie müssen dieses Repository nicht klonen oder eine virtuelle Umgebung
verwalten – uvx erledigt alles über die Git-URL.
Related MCP server: EODHD MCP Server
Installation
Claude Code
Die Installation per Einzeiler, ausgeführt aus einem Ordner, dessen .env Ihre
drei EIU-Werte enthält. Die Shell liest sie ein, sodass die Anmeldedaten nie in
Ihrer Konversation auftauchen:
set -a; source .env; set +a
claude mcp add --scope user eiu \
-e EIU_API_KEY="$EIU_API_KEY" \
-e EIU_EMAIL="$EIU_EMAIL" \
-e EIU_PASSWORD="$EIU_PASSWORD" \
-- uvx --from git+https://github.com/joshua-bailey/eiu-mcp-server.git eiu-mcp-serverOder fügen Sie den Eintrag von Hand in .mcp.json hinzu:
{
"mcpServers": {
"eiu": {
"command": "uvx",
"args": [
"--from",
"git+https://github.com/joshua-bailey/eiu-mcp-server.git",
"eiu-mcp-server"
],
"env": {
"EIU_API_KEY": "${EIU_API_KEY}",
"EIU_EMAIL": "${EIU_EMAIL}",
"EIU_PASSWORD": "${EIU_PASSWORD}"
}
}
}
}Starten Sie dann Claude Code neu. Die drei eiu_*-Tools sollten unter /mcp
erscheinen.
Claude Desktop
Dasselbe JSON-Snippet, eingefügt unter mcpServers in:
macOS:
~/Library/Application Support/Claude/claude_desktop_config.jsonWindows:
%APPDATA%\Claude\claude_desktop_config.json
Claude Desktop löst keine ${VAR}-Referenzen auf; tragen Sie dort stattdessen
die tatsächlichen Werte ein.
Eine Version festlegen
uvx installiert standardmäßig den neuesten Commit auf main. Um eine Version
auf ein bestimmtes Release-Tag festzulegen, hängen Sie @<tag> an die Git-URL
an, z. B.:
"git+https://github.com/joshua-bailey/eiu-mcp-server.git@v0.1.0"Umgebungsvariablen
Variable | Erforderlich? | Zweck |
| Ja | Ihr EIU-API-Schlüssel aus dem Developer Portal. |
| Ja | Die E-Mail-Adresse, die Ihr Portal-Konto verwendet. |
| Ja | Ihr Portal-Passwort. |
Alle drei werden benötigt. Der Server meldet sich mit E-Mail-Adresse und Passwort an, um ein Bearer-Token zu erhalten, und sendet dieses Token zusammen mit dem API-Schlüssel bei jeder Anfrage. Das Token wird im Speicher zwischengespeichert und vor Ablauf aktualisiert.
Verwendung
Sobald der MCP registriert ist, können Sie Claude zum Beispiel Folgendes fragen:
„Suche in EIU nach Serien zum Leistungsbilanzsaldo"
„Welche EIU-Seriencodes decken Verbraucherpreise ab?"
„Rufe EIU-Daten zum jährlichen BIP-Wachstum (DGDP) für die USA, Großbritannien und China von 2015 bis 2030 ab"
„Zeig mir EIU-Prognosen zur vierteljährlichen Inflation für Brasilien, Mexiko und Chile"
Claude wählt das passende Tool aus und ruft es auf.
Codes
Geografien sind zweistellige ISO-Codes in Großbuchstaben:
US,GB,CN,BR.Serien sind EIU-eigene Kurzcodes in Großbuchstaben, z. B.
DGDP,DCPI. Nutzen Sieeiu_searchodereiu_browse, um sie zu finden, statt zu raten.Häufigkeit ist einer der Werte
Yearly,QuarterlyoderMonthly.
eiu_get_data begrenzt die Antwort auf 200 Datenpunkte, um token-effizient zu
bleiben, und weist darauf hin, wenn es die Antwort kürzt. Verkleinern Sie den
Datumsbereich oder die Länderliste, um den Rest zu sehen.
API-Referenz
Die zugrunde liegende API ist unter
developer.eiu.com/help/overview
dokumentiert. Der Server kommuniziert mit https://api.eiu.com/v1.
Lizenz
MIT – siehe LICENSE. Gilt nur für den Wrapper-Code in diesem Repository. Abhängigkeiten behalten ihre eigenen Lizenzen. EIU-Daten sind ein kostenpflichtiges Abonnement, dessen Nutzungsbedingungen unabhängig von diesem Wrapper gelten.
Available Tools
3 toolseiu_browseA
Browse available EIU geographies and data series.
Call with no filter to see all available geographies/series. Use filter to narrow results by keyword.
Args: filter: Optional keyword (e.g. 'Brazil', 'GDP', 'inflation') show: 'geographies', 'series', or 'both' (default)
| Name | Required | Description | Default |
|---|---|---|---|
| show | No | both | |
| filter | No |
Output Schema
| Name | Required | Description |
|---|---|---|
| result | Yes |
TDQS
A4.6/5.0
Behavior4/5
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
With no annotations, the description carries the behavioral burden. It explains what happens with no filter versus with a filter and describes the show options. It does not mention output format or pagination, but the presence of an output schema reduces the need for that detail.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Conciseness5/5
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is compact and well-organized: a summary line, short usage guidance, and a clean args list. Every sentence contributes value, with no repetition or filler.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Completeness5/5
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
For a simple two-parameter browse tool, the description is complete. It covers all parameters, defaults, and core behavior, and the output schema exists to document return values. The lack of explicit sibling routing is the only minor omission, but the intended use is clear.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Parameters5/5
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema coverage is 0%, and the description fully compensates. It defines filter as an optional keyword with concrete examples, and show as selecting 'geographies', 'series', or 'both' with the default noted. This is meaningful semantic content beyond the bare schema.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Purpose5/5
Does the description clearly state what the tool does and how it differs from similar tools?
The description opens with a specific verb and resource: 'Browse available EIU geographies and data series.' This clearly distinguishes it from siblings like eiu_get_data and eiu_search, which presumably retrieve or search data rather than browse the catalog.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Usage Guidelines4/5
Does the description explain when to use this tool, when not to, or what alternatives exist?
The description gives clear operational context: 'Call with no filter to see all available geographies/series. Use filter to narrow results by keyword.' It explains how to use the tool and the effect of each parameter, though it does not explicitly state when to prefer eiu_search or eiu_get_data.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
eiu_get_dataA
Fetch EIU forecast/indicator data by country and series codes.
Use eiu_browse or eiu_search first to find valid codes.
Args: geography_codes: ISO 2-char codes (e.g. ['US', 'BR', 'CN']) series_codes: EIU series codes (e.g. ['DGDP', 'DCPI']) frequency: 'Yearly', 'Quarterly', or 'Monthly' min_date: Start date YYYY-MM-DD (default: 5 years ago) max_date: End date YYYY-MM-DD (default: 5 years ahead)
| Name | Required | Description | Default |
|---|---|---|---|
| max_date | No | ||
| min_date | No | ||
| frequency | No | Quarterly | |
| series_codes | Yes | ||
| geography_codes | Yes |
Output Schema
| Name | Required | Description |
|---|---|---|
| result | Yes |
TDQS
A4.8/5.0
Behavior4/5
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
With no annotations provided, the description carries the full burden. It clearly implies a read-only fetch operation, states the prerequisite of finding valid codes first, and documents default date ranges and accepted frequency values. It could add error/rate-limit behavior, but the default date behavior and non-destructive nature are usefully conveyed.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Conciseness5/5
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is compact and well-structured. The high-level purpose is front-loaded, the prerequisite is stated in a single sentence, and the Args block is clean and easy to scan. No sentence is wasted or redundant.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Completeness5/5
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
Given the tool has an output schema, return-value documentation is not needed. The description covers all five parameters, provides valid examples, explains the required discovery workflow, and states defaults. Everything an agent needs to invoke the tool correctly is present.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Parameters5/5
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema description coverage is 0%, so the description fully compensates. It explains every parameter: ISO 2-char geography codes with examples, EIU series codes with examples, allowed frequency values, and date format/defaults for min_date and max_date. This is far beyond the bare schema.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Purpose5/5
Does the description clearly state what the tool does and how it differs from similar tools?
The description uses a specific verb ('Fetch') and a specific resource ('EIU forecast/indicator data') with clear scope by country and series codes. This distinguishes it well from the sibling tools eiu_browse and eiu_search, which are for finding codes rather than retrieving data.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Usage Guidelines5/5
Does the description explain when to use this tool, when not to, or what alternatives exist?
It explicitly explains the intended workflow: use eiu_browse or eiu_search first to find valid codes, then call this tool. This is clear guidance on when to use this tool versus the alternatives, leaving no ambiguity for the agent.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
eiu_searchA
Search EIU series by keyword in cached reference data.
Use this to find series codes before calling eiu_get_data.
Args: query: Search terms (e.g. 'GDP', 'consumer prices', 'exchange rate') limit: Max results (default 25, max 100)
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | ||
| query | Yes |
Output Schema
| Name | Required | Description |
|---|---|---|
| result | Yes |
TDQS
A3.9/5.0
Behavior3/5
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
With no annotations, the description is the only source of behavioral context. It adds useful facts about cached reference data and the limit cap (max 100) beyond the schema, but it does not state read-only behavior, output characteristics, or error handling. Acceptable for a simple read-oriented search, but it is not rich.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Conciseness5/5
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is concise and front-loaded: a one-sentence purpose, a clear usage pointer, and a compact Args block. No redundant wording or filler; every sentence contributes.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Completeness4/5
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
The tool is simple, has an output schema to cover return values, and the description provides param details plus sequencing with eiu_get_data. It is slightly incomplete in not addressing the relationship to eiu_browse, but it contains the essential context for correct invocation.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Parameters4/5
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema description coverage is 0%, but the description compensates by explaining both parameters: query with concrete examples and limit with default and max. It adds meaning beyond the schema, though it could be more precise about the interpretation of 'limit' (number of results vs. something else).
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Purpose4/5
Does the description clearly state what the tool does and how it differs from similar tools?
The description states a clear verb and resource: search EIU series by keyword in cached reference data. It also notes the downstream use (finding series codes before calling eiu_get_data), but it does not explicitly differentiate from the sibling eiu_browse, so purpose is clear but sibling distinction is left implicit.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Usage Guidelines4/5
Does the description explain when to use this tool, when not to, or what alternatives exist?
The description gives explicit guidance: 'Use this to find series codes before calling eiu_get_data.' This establishes when to use the tool relative to eiu_get_data, but it does not mention alternatives such as eiu_browse or exclusions, so it falls short of full when/when-not coverage.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
3 tool updates
v0.1.0- First observed
eiu_browse - First observed
eiu_get_data - First observed
eiu_search
TDQS
A4.1/5.0
Scored across 3 tools
Disambiguation3/5
eiu_browse and eiu_search both support keyword-based series discovery, so agents may be unsure which to call when looking up series codes. eiu_browse is broader because it also covers geographies, while eiu_search is narrowly focused on series, but the boundary is somewhat blurred. eiu_get_data is clearly distinct.
Naming Consistency4/5
All tools share the eiu_ prefix and use lower_snake_case, making the naming pattern predictable. However, eiu_browse and eiu_search are bare verbs while eiu_get_data is verb_noun, which is a minor inconsistency.
Tool Count4/5
Three tools is a reasonable, compact set for a browse/search/fetch data workflow. The count is appropriate, though eiu_browse and eiu_search overlap enough that the set could arguably be reduced to two tools.
Completeness4/5
The core workflow of discovering geographies and series, then fetching EIU data, is covered without dead ends. Minor gaps exist around metadata details or available date ranges, but agents can complete the primary task effectively.
Maintenance
ActivityMaintained
ResponsivenessNo issues
Related MCP Connectors
Browse and query the EIA API v2 — electricity, petroleum, natural gas, coal, forecasts via MCP.
World Bank MCP — wraps the World Bank Data API v2 (free, no auth)
Macroeconomic and other official data from 170+ publishers, resolved from natural language with provenance.
Official World Bank macro indicators (GDP, inflation...) by country. $0.005/call via x402.
Related MCP Servers
- AlicenseNot gradedqualityCmaintenanceEnables interaction with EOD Historical Data APIs, providing access to 75 read-only tools for financial data including fundamentals, news, screeners, and options via MCP transports.23MIT
- AlicenseAqualityAmaintenanceEnables MCP-compatible clients to access Canadian statistical data from Statistics Canada via WDS and SDMX APIs, including search, download, and analysis capabilities.251,093 PyPI7MIT
- FlicenseNot gradedqualityDmaintenanceExposes World Bank development data and country information via MCP resources and tools, enabling AI agents to query historical indicators and live API data.-
