ElkassabgiData

Working · 2.2 s

com.elkassabgidata/elkassabgidatav1.0.1 Domain verified

A growing family of free academic data libraries: finance, economics, and beyond (ElkassabgiData).

Data & Databases Finance & Payments

Source Website Registry entry

Maintain this server? Claim it

Try it

Call this server's tools from your browser. Nothing to install.

https://elkassabgidata-mcp.elkassabgi.workers.dev/mcp

X-API-Key (optional)

Free ElkassabgiData API key — one free account works across every ElkassabgiData library (only needed for data-download tools; search/browse works anonymously). Get one at hfdatalibrary.com/pages/download

Requests go through mcptry because browsers can't call most MCP servers directly. Header values are sent to the server for that request only and are never stored or logged.

Tool list from our last check. Connect live to refresh it.

get_auth_status Read-only

Whether this MCP connection has an ElkassabgiData API key configured (masked — the key itself is never echoed), and how to add one.

This tool takes no arguments.

Tools (12)

get_auth_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

No arguments.

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {}
}

get_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

Argument	Type	Description
source	string	One source id; omit for the full board

Input schema (JSON)

{
  "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

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

Argument	Type	Description
ids	array	Up to 50 exact catalog ids from search_econ_series
source	string	One source id - every series of that source, if it has at most 1,000

Input schema (JSON)

{
  "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 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

Argument	Type	Description
date_to	string
max_rows	integer
date_from	string
series_id*	string	Exact catalog id from search_econ_series, e.g. 'worldbank:NY.GDP.MKTP.CD:DEU'

Input schema (JSON)

{
  "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

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

Argument	Type	Description
series_id*	string

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "series_id"
  ],
  "properties": {
    "series_id": {
      "type": "string"
    }
  },
  "additionalProperties": false
}

get_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

No arguments.

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {}
}

get_hf_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 to the present; parquet or csv) or the 25 pre-computed academic variables. Each file holds all of a ticker's bars, so it is fetched by YOUR code, not returned inline. The data is provided for academic research; relay that notice with the link. Works with the same ElkassabgiData key.

read-only

Argument	Type	Description
format	string	csv only applies to bars
ticker*	string	e.g. AAPL, SPY
dataset	string
version	string

Input schema (JSON)

{
  "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

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

No arguments.

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {}
}

get_ip_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

Argument	Type	Description
file*	string
vintage	string	Snapshot vintage from list_ip_bundles; omit for the newest

Input schema (JSON)

{
  "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 the Econ Data Library's sources (statistical offices, monetary authorities, IGOs, research datasets) with their licenses, counted live. Free.

read-only

Argument	Type	Description
contains	string	Case-insensitive filter on source id/name, e.g. 'bank' or 'imf'

Input schema (JSON)

{
  "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

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

No arguments.

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {}
}

search_econ_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

Argument	Type	Description
lang	string	Title language. Only official translations are shown; a title without one stays in English.
limit	integer
query*	string	Free-text search, e.g. 'germany inflation' or 'GDP per capita'
offset	integer	Skip this many results (paging). The API caps how deep it pages and says so if exceeded.
source	string	Restrict to one source id, e.g. 'worldbank', 'ecb', 'imf_weo'

Input schema (JSON)

{
  "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
}