ElkassabgiData

Search the Econ Data Library catalog (billions of series from 300+ sources: national accounts, prices, trade, labor, energy, markets…). Free, no key needed. Returns series ids usable with get_econ_series.

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "minLength": 2,
      "description": "Free-text search, e.g. 'germany inflation' or 'GDP per capita'"
    },
    "source": {
      "type": "string",
      "description": "Restrict to one source id, e.g. 'worldbank', 'ecb', 'imf_weo'"
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 50,
      "default": 15
    }
  },
  "required": [
    "query"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

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.

{
  "type": "object",
  "properties": {
    "series_id": {
      "type": "string",
      "description": "Exact catalog id from search_econ_series, e.g. 'worldbank:NY.GDP.MKTP.CD:DEU'"
    },
    "date_from": {
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
    },
    "date_to": {
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
    },
    "max_rows": {
      "type": "integer",
      "minimum": 10,
      "maximum": 2000,
      "default": 400
    }
  },
  "required": [
    "series_id"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Full metadata for one econ series: title, frequency, geography, unit, license (incl. commercial-use flag), attribution/citation, coverage dates. Free, no key needed.

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

List the Econ Data Library's sources (309: statistical offices, central banks, IGOs, research datasets) with their licenses. Free.

{
  "type": "object",
  "properties": {
    "contains": {
      "type": "string",
      "description": "Case-insensitive filter on source id/name, e.g. 'bank' or 'imf'"
    }
  },
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

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.

{
  "type": "object",
  "properties": {
    "source": {
      "type": "string",
      "description": "One source id; omit for the full board"
    }
  },
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Authenticated download instructions for HF Data Library's 1-minute OHLCV bars (full per-ticker history, 1,391 US stocks/ETFs, 2002→yesterday; parquet or csv) or the 25 pre-computed academic variables. Files are full-history (up to millions of rows) so they are fetched by YOUR code, not returned inline. Works with the same ElkassabgiData key.

{
  "type": "object",
  "properties": {
    "ticker": {
      "type": "string",
      "pattern": "^[A-Za-z0-9.]{1,10}$",
      "description": "e.g. AAPL, SPY"
    },
    "dataset": {
      "type": "string",
      "enum": [
        "bars",
        "variables",
        "quality"
      ],
      "default": "bars"
    },
    "version": {
      "type": "string",
      "enum": [
        "clean",
        "raw"
      ],
      "default": "clean"
    },
    "format": {
      "type": "string",
      "enum": [
        "parquet",
        "csv"
      ],
      "default": "parquet",
      "description": "csv only applies to bars"
    }
  },
  "required": [
    "ticker"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

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.

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

List the IP Data Library's snapshot-pinned patent/innovation bundles (patent-level measures on 9.4M+ US patents; assignee-year panels) with sizes, vintages and download paths. Free, no key needed.

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

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.

{
  "type": "object",
  "properties": {
    "file": {
      "type": "string",
      "enum": [
        "patent_measures.parquet",
        "assignee_year.parquet"
      ]
    },
    "vintage": {
      "type": "string",
      "pattern": "^v[\\w.-]+$",
      "description": "Snapshot vintage from list_ip_bundles; omit for the newest"
    }
  },
  "required": [
    "file"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Live status of the whole ElkassabgiData family: both libraries' headline stats and data currency. Free.

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

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

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