ElkassabgiData

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.

{
  "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
    },
    "offset": {
      "type": "integer",
      "minimum": 0,
      "default": 0,
      "description": "Skip this many results (paging). The API caps how deep it pages and says so if exceeded."
    },
    "lang": {
      "type": "string",
      "enum": [
        "en",
        "ar",
        "es",
        "fr",
        "ru",
        "zh"
      ],
      "default": "en",
      "description": "Title language. Only official translations are shown; a title without one stays in English."
    }
  },
  "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 (statistical offices, monetary authorities, IGOs, research datasets) with their licenses, counted live. 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#"
}

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.

{
  "type": "object",
  "properties": {
    "ids": {
      "type": "array",
      "items": {
        "type": "string",
        "minLength": 3
      },
      "minItems": 1,
      "maxItems": 50,
      "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,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

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.

{
  "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 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 - HF, Econ and IP: each library's headline stats and data currency, read live. 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#"
}