MCP Server

ElkassabgiData

com.elkassabgidata/elkassabgidata
Data & Analytics Finance & Investing Public & reachable MCP 2025-11-25

What this MCP does

Offers searchable economic time series, financial market data downloads, patent and innovation datasets, metadata, source licensing, and freshness information.

get_auth_status
Authentication Status
Whether this MCP connection has an ElkassabgiData API key configured (masked — the key itself is never echoed), and how to add one.
Read only
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {}}
get_data_freshness
Data Freshness
Live per-source update status straight from the automated updater's ledger: last successful update, data frontier, and honest stale/failure flags (dates are NEVER fabricated — a silent upstream outage shows here as stale, not papered over). Free.
Read only
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'source': {'type': 'string', 'description': 'One source id; omit for the full board'}}, 'additionalProperties': False}
get_econ_bundle_manifest
Economic Data Bundle Manifest
A citable bundle manifest (Frictionless data package) for several econ series - up to 50 explicit ids, or every series of one small source (up to 1,000 series): the per-series download URLs grouped by source, each source's attribution and licence, and any id that could not be resolved (reported, never dropped). The URLs serve the CURRENT data - this is not a frozen vintage. Free, no key needed for the manifest; downloading the URLs needs the key.
Read only
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'ids': {'type': 'array', 'items': {'type': 'string', 'minLength': 3}, 'maxItems': 50, 'minItems': 1, 'description': 'Up to 50 exact catalog ids from search_econ_series'}, 'source': {'type': 'string', 'description': 'One source id - every series of that source, if it has at most 1,000'}}, 'additionalProperties': False}
get_econ_series
Download Economic Series
Download an economic time series as rows (long format: date, value) with its citation and license. REQUIRES the free ElkassabgiData API key. Use date_from/date_to to window long series.
Read only
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['series_id'], 'properties': {'date_to': {'type': 'string', 'pattern': '^\\d{4}-\\d{2}-\\d{2}$'}, 'max_rows': {'type': 'integer', 'default': 400, 'maximum': 2000, 'minimum': 10}, 'date_from': {'type': 'string', 'pattern': '^\\d{4}-\\d{2}-\\d{2}$'}, 'series_id': {'type': 'string', 'description': "Exact catalog id from search_econ_series, e.g. 'worldbank:NY.GDP.MKTP.CD:DEU'"}}, 'additionalProperties': False}
get_econ_series_metadata
Economic Series Metadata
Full metadata for one econ series: title, frequency, geography, unit, license (incl. commercial-use flag), attribution/citation, coverage dates. Free, no key needed.
Read only
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['series_id'], 'properties': {'series_id': {'type': 'string'}}, 'additionalProperties': False}
get_family_status
ElkassabgiData Family Status
Live status of the whole ElkassabgiData family - HF, Econ and IP: each library's headline stats and data currency, read live. Free.
Read only
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {}}
get_hf_download_link
HF Equity Data Download Link
Authenticated download instructions for HF Data Library's 1-minute OHLCV bars (per-ticker US stocks/ETFs from IEX Exchange HIST, 2022-03-07 onward; parquet or csv) or the 25 pre-computed academic variables. Each file holds a ticker's whole history, so it is fetched by YOUR code, not returned inline. HF downloads are paused while the dataset is restructured (the URL answers 503 data_paused). Works with the same ElkassabgiData key.
Read only
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['ticker'], 'properties': {'format': {'enum': ['parquet', 'csv'], 'type': 'string', 'default': 'parquet', 'description': 'csv only applies to bars'}, 'ticker': {'type': 'string', 'pattern': '^[A-Za-z0-9.]{1,10}$', 'description': 'e.g. AAPL, SPY'}, 'dataset': {'enum': ['bars', 'variables', 'quality'], 'type': 'string', 'default': 'bars'}, 'version': {'enum': ['clean', 'raw'], 'type': 'string', 'default': 'clean'}}, 'additionalProperties': False}
get_hf_variables_dictionary
HF Variables Dictionary
The exact definitions/formulas of HF Data Library's 25 pre-computed academic variables (realized volatility family, spreads, jumps, liquidity, data-quality). Verbatim from the published dictionary. Free.
Read only
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {}}
get_ip_download_link
IP Patent Data Download Link
Authenticated download instructions for an IP Data Library bundle — patent-level innovation measures (citations, originality/generality, grant lag, team size) or the assignee-year panel. Parquet, full-history files fetched by YOUR code, not returned inline. Works with the same ElkassabgiData key as every family library.
Read only
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['file'], 'properties': {'file': {'enum': ['patent_measures.parquet', 'assignee_year.parquet'], 'type': 'string'}, 'vintage': {'type': 'string', 'pattern': '^v[\\w.-]+$', 'description': 'Snapshot vintage from list_ip_bundles; omit for the newest'}}, 'additionalProperties': False}
list_econ_sources
List Economic Data Sources
List the Econ Data Library's sources (statistical offices, monetary authorities, IGOs, research datasets) with their licenses, counted live. Free.
Read only
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'contains': {'type': 'string', 'description': "Case-insensitive filter on source id/name, e.g. 'bank' or 'imf'"}}, 'additionalProperties': False}
list_ip_bundles
IP Data Library Bundles
List the IP Data Library's snapshot-pinned patent/innovation bundles (patent-level measures on US patents; assignee-year panels) with sizes, vintages and download paths. Free, no key needed.
Read only
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {}}
search_econ_series
Search Economic Series
Search the Econ Data Library catalog (billions of series from hundreds of sources: national accounts, prices, trade, labor, energy, markets…). Free, no key needed. Returns series ids usable with get_econ_series. Page with offset; lang returns source-official translated titles where the publisher provides them.
Read only
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['query'], 'properties': {'lang': {'enum': ['en', 'ar', 'es', 'fr', 'ru', 'zh'], 'type': 'string', 'default': 'en', 'description': 'Title language. Only official translations are shown; a title without one stays in English.'}, 'limit': {'type': 'integer', 'default': 15, 'maximum': 50, 'minimum': 1}, 'query': {'type': 'string', 'minLength': 2, 'description': "Free-text search, e.g. 'germany inflation' or 'GDP per capita'"}, 'offset': {'type': 'integer', 'default': 0, 'minimum': 0, 'description': 'Skip this many results (paging). The API caps how deep it pages and says so if exceeded.'}, 'source': {'type': 'string', 'description': "Restrict to one source id, e.g. 'worldbank', 'ecb', 'imf_weo'"}}, 'additionalProperties': False}
Changed
get_hf_download_link
Oct. 5, 2026, 2:54 a.m.
Changed
get_family_status
Oct. 3, 2026, 3 a.m.
Changed
list_ip_bundles
Oct. 3, 2026, 3 a.m.
Changed
get_hf_download_link
Oct. 3, 2026, 3 a.m.
Added
get_econ_bundle_manifest
Oct. 3, 2026, 3 a.m.
Changed
list_econ_sources
Oct. 3, 2026, 3 a.m.
Changed
search_econ_series
Oct. 3, 2026, 3 a.m.
Added
get_auth_status
Sept. 17, 2026, 12:34 p.m.
Added
get_family_status
Sept. 17, 2026, 12:34 p.m.
Added
get_ip_download_link
Sept. 17, 2026, 12:34 p.m.
Added
list_ip_bundles
Sept. 17, 2026, 12:34 p.m.
Added
get_hf_variables_dictionary
Sept. 17, 2026, 12:34 p.m.
Added
get_hf_download_link
Sept. 17, 2026, 12:34 p.m.
Added
get_data_freshness
Sept. 17, 2026, 12:34 p.m.
Added
list_econ_sources
Sept. 17, 2026, 12:34 p.m.
Added
get_econ_series_metadata
Sept. 17, 2026, 12:34 p.m.
Added
get_econ_series
Sept. 17, 2026, 12:34 p.m.
Added
search_econ_series
Sept. 17, 2026, 12:34 p.m.