Economics
Data source: Federal Reserve Economic Data
MCP Protocol
Endpoint
https://context.gnist.ai/mcp/fred/
claude_desktop_config.json
{
"mcpServers": {
"gnist-fred": {
"url": "https://context.gnist.ai/mcp/fred/",
"headers": {
"Gnist-API-Key": "YOUR_API_KEY"
}
}
}
}
Shell
curl -X POST "https://context.gnist.ai/mcp/fred/" \
-H "Content-Type: application/json" \
-H "Accept: application/json, text/event-stream" \
-H "Gnist-API-Key: YOUR_API_KEY" \
-d '{"jsonrpc": "2.0", "method": "tools/call", "id": 1, "params": {"name": "get_series", "arguments": {"series_id": "example"}}}'
REST API
API Root
https://context.gnist.ai/rest/fred/
6 endpoints available:
GET /rest/fred/get_seriesGET /rest/fred/search_seriesGET /rest/fred/get_series_infoGET /rest/fred/get_categoryGET /rest/fred/compare_seriesGET /rest/fred/report_feedback
Shell
curl "https://context.gnist.ai/rest/fred/get_series?series_id=example" \ -H "Gnist-API-Key: YOUR_API_KEY"
Python
import httpx
resp = httpx.get(
"https://context.gnist.ai/rest/fred/get_series",
headers={"Gnist-API-Key": "YOUR_API_KEY"},
params={
"series_id": "example"
},
)
print(resp.json())
Command Line
Command
gc fred
CLI documentation will be available when the GnistAI SDK is published.
Install
pip install gnistai
Available Tools (6)
get_seriesGet economic time series observations from FRED.
| Parameter | Type | Required | Description |
|---|---|---|---|
series_id | string | required | FRED series identifier (e.g. "FEDFUNDS", "UNRATE", "GDP"). |
observation_start | any | optional | Start date (YYYY-MM-DD). If omitted, fetches from the series start. |
observation_end | any | optional | End date (YYYY-MM-DD). If omitted, fetches to the latest available observation. |
frequency | any | optional | Aggregate to lower frequency. Options: "d" (daily), "w" (weekly), "bw" (biweekly), "m" (monthly), "q" (quarterly), "sa" (semiannual), "a" (annual). |
aggregation_method | any | optional | How to aggregate when changing frequency. Options: "avg" (default), "sum", "eop". |
limit | integer | optional | Maximum observations to return (default 100, max 100000). (default: 100) |
search_seriesSearch FRED for economic time series matching a query.
| Parameter | Type | Required | Description |
|---|---|---|---|
query | string | required | Search terms to match against FRED series names and notes. |
limit | integer | optional | Maximum results to return (default 20, max 1000). (default: 20) |
get_series_infoGet metadata for a FRED series without fetching observations.
| Parameter | Type | Required | Description |
|---|---|---|---|
series_id | string | required | FRED series identifier (e.g. "FEDFUNDS", "UNRATE", "GDP"). |
get_categoryBrowse FRED's category hierarchy.
| Parameter | Type | Required | Description |
|---|---|---|---|
category_id | integer | optional | Integer category ID. Default 0 returns the root categories. Pass a child category ID to drill down. IDs for common top-level categories: - 32991: Money, Banking & Finance - 10: National Accounts - ... (default: 0) |
compare_seriesFetch multiple FRED series aligned to a common time axis.
| Parameter | Type | Required | Description |
|---|---|---|---|
series_ids | list[string] | required | List of 2–10 FRED series IDs to compare. |
observation_start | any | optional | Start date (YYYY-MM-DD) applied to all series. |
observation_end | any | optional | End date (YYYY-MM-DD) applied to all series. |
frequency | any | optional | Aggregate all series to this frequency before aligning (e.g. "q" for quarterly, "a" for annual). |
report_feedbackReport a bug, feature request, or general feedback for this data source.
| Parameter | Type | Required | Description |
|---|---|---|---|
feedback | string | required | |
feedback_type | string | optional | (default: "general") |