FRED Economic Data
GDP, unemployment, CPI, interest rates, and 800K+ economic time series from the Federal Reserve
Should I use this
Quality & Safety
Based on automated analysis of tool definitions and protocol compliance.
Context Cost
This is the approximate number of tokens consumed each time the server's tools are loaded into a model's context. Higher counts reduce the attention available for other tasks.
Install
One-Click Install
Add this to your `claude_desktop_config.json` file:
{
"mcpServers": {
"fred": {
"url": "https://mcp.olyport.com/fred/mcp"
}
}
}Remote endpoints
https://mcp.olyport.com/fred/mcpstreamable-httpWhat it can do
Tool inventory
Tools (5)
🟢search_series(search_text, limit)
Search for FRED economic data series by keyword. Use this to find series IDs for economic indicators. For example, search 'unemployment rate' to find UNRATE, or 'gross domestic product' to find GDP. Returns series metadata including ID, title, frequency, units, and date range. Common series: UNRATE (unemployment), GDP (gross domestic product), CPIAUCSL (consumer price index), FEDFUNDS (federal funds rate), MORTGAGE30US (30-year mortgage rate), MEHOINUSA672N (median household income). Args: search_text: Keywords to search for (e.g. 'unemployment rate', 'GDP', 'inflation'). limit: Maximum number of results to return (default 10, max 1000).
Input Schema
{
"type": "object",
"properties": {
"search_text": {
"title": "Search Text",
"type": "string"
},
"limit": {
"default": 10,
"title": "Limit",
"type": "integer"
}
},
"required": [
"search_text"
],
"title": "search_seriesArguments"
}Output Schema
{
"type": "object",
"properties": {
"result": {
"title": "Result",
"type": "string"
}
},
"required": [
"result"
],
"title": "search_seriesOutput"
}🟢get_series_observations(series_id, start_date, end_date, limit)
Get time series observations (data points) for a FRED series. Returns the actual data values for an economic indicator over time. Use search_series first to find the series_id, or use well-known IDs like UNRATE, GDP, CPIAUCSL, FEDFUNDS, MORTGAGE30US. For state unemployment, use state abbreviation + 'UR' (e.g. WAUR for Washington, CAUR for California). Results are sorted most-recent-first. For long series (e.g. daily data since 1954), use start_date/end_date to narrow the window or increase the limit up to 10000. Args: series_id: FRED series identifier (e.g. 'UNRATE', 'GDP', 'CPIAUCSL'). start_date: Optional start date in YYYY-MM-DD format (e.g. '2020-01-01'). end_date: Optional end date in YYYY-MM-DD format (e.g. '2024-12-31'). limit: Maximum observations to return (default 1000, max 10000).
Input Schema
{
"type": "object",
"properties": {
"series_id": {
"title": "Series Id",
"type": "string"
},
"start_date": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Start Date"
},
"end_date": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "End Date"
},
"limit": {
"default": 1000,
"title": "Limit",
"type": "integer"
}
},
"required": [
"series_id"
],
"title": "get_series_observationsArguments"
}Output Schema
{
"type": "object",
"properties": {
"result": {
"title": "Result",
"type": "string"
}
},
"required": [
"result"
],
"title": "get_series_observationsOutput"
}🟢get_series_info(series_id)
Get metadata and details for a specific FRED series. Returns comprehensive information about a series including its title, frequency, units, seasonal adjustment, source, and date range. Use this to understand what a series measures before pulling observations. Args: series_id: FRED series identifier (e.g. 'UNRATE', 'GDP', 'CPIAUCSL').
Input Schema
{
"type": "object",
"properties": {
"series_id": {
"title": "Series Id",
"type": "string"
}
},
"required": [
"series_id"
],
"title": "get_series_infoArguments"
}Output Schema
{
"type": "object",
"properties": {
"result": {
"title": "Result",
"type": "string"
}
},
"required": [
"result"
],
"title": "get_series_infoOutput"
}🟢get_category_series(category_id)
Get all FRED series within a specific category. FRED organizes data into a hierarchy of categories. Use this to browse available series within a topic area. Common category IDs: - 32991: Money, Banking, & Finance - 10: Population, Employment, & Labor Markets - 32992: National Accounts (GDP) - 1: Production & Business Activity - 32455: Prices (CPI, PPI) - 97: Housing Args: category_id: FRED category identifier (integer).
Input Schema
{
"type": "object",
"properties": {
"category_id": {
"title": "Category Id",
"type": "integer"
}
},
"required": [
"category_id"
],
"title": "get_category_seriesArguments"
}Output Schema
{
"type": "object",
"properties": {
"result": {
"title": "Result",
"type": "string"
}
},
"required": [
"result"
],
"title": "get_category_seriesOutput"
}🟢get_release_dates(release_id)
Get release dates for a specific FRED data release. Returns the dates when a particular data release was published. Useful for tracking when economic indicators are updated. Common release IDs: - 10: Consumer Price Index - 46: Producer Price Index - 50: Employment Situation (jobs report) - 53: Gross Domestic Product - 17: Federal Reserve H.15 (interest rates) - 21: Federal Reserve H.6 (money stock) Args: release_id: FRED release identifier (integer).
Input Schema
{
"type": "object",
"properties": {
"release_id": {
"title": "Release Id",
"type": "integer"
}
},
"required": [
"release_id"
],
"title": "get_release_datesArguments"
}Output Schema
{
"type": "object",
"properties": {
"result": {
"title": "Result",
"type": "string"
}
},
"required": [
"result"
],
"title": "get_release_datesOutput"
}Community
Evidence