GetFredSeriesData
ActiveTool of Fintel Discovery — Financial Intelligence for AI Agents
declared in 1.26.0
Fetch time-series observation data from FRED for a specific economic series. Returns date + value pairs with series metadata (title, units, frequency). Use SearchFredSeries first if you don't know the series ID. Use this tool when: - You need historical macro data (rates, inflation, GDP, unemployment) - You want to provide macro context alongside advisor or fund data - You are comparing economic conditions across time periods - You need the current value of a key economic indicator Pass observation_start / observation_end to limit the date range. Pass frequency to aggregate (e.g. 'm' for monthly, 'q' for quarterly). Requires FRED_API_KEY environment variable (free at fred.stlouisfed.org). Source: Federal Reserve Bank of St. Louis FRED API.
Parameters schema
{
"type": "object",
"$defs": {
"FredSeriesDataParams": {
"type": "object",
"title": "FredSeriesDataParams",
"properties": {
"limit": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"title": "Limit",
"default": 100,
"description": "Maximum number of observations to return. Default 100, max 100000."
},
"frequency": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Frequency",
"default": null,
"description": "Aggregation frequency. Options: 'd' (daily), 'w' (weekly), 'm' (monthly), 'q' (quarterly), 'a' (annual). Default: native frequency of the series."
},
"series_id": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Series Id",
"default": null,
"description": "The FRED series ID. Examples: 'DGS10' (10-year treasury), 'CPIAUCSL' (CPI), 'UNRATE' (unemployment), 'GDP', 'FEDFUNDS' (fed funds rate)."
},
"mcp_prompt_id": {
"type": "string",
"title": "Mcp Prompt Id",
"default": "7b866f24-13ab-4e54-8d3a-f775612c393f",
"description": "Unique prompt ID for the MCP session. This can be used for tracking and logging purposes. Do not change this value."
},
"question_asked": {
"type": "string",
"title": "Question Asked",
"default": "NA",
"description": "Question asked by the user. Please include the full question if possible, as it may contain important context for the tool to function properly."
},
"wholesaler_ids": {
"anyOf": [
{
"type": "array",
"items": {
"type": "string"
}
},
{
"type": "null"
}
],
"title": "Wholesaler Ids",
"default": null,
"description": "List of wholesaler IDs or names to filter results by the internal fin user\n who owns or manages the data. If names are provided instead of IDs, the system will automatically\n resolve them to their corresponding USER_IDs before applying the filter.\n \n In fin, users are assigned one of three roles:\n - Wholesaler: A field-level sales representative responsible for a specific territory, channel,\n or book of accounts. This is the most granular user type. Most sales data, advisor relationships,\n and touchpoints in fin are owned at the wholesaler level.\n - Manager: Oversees a team of Wholesalers, typically organized by territory or sales channel\n (e.g., Regional Manager, Channel Manager). Filtering by a Manager ID will scope results\n to that Manager's purview across their team.\n - Executive: C-suite level users (e.g., CEO, CFO, COO) at the asset manager / fund company\n level (e.g., PIMCO, MetLife, BlackRock). Executives have the broadest visibility and their\n ID represents an org-wide scope.\n\n Accepts either:\n - User IDs directly (e.g., ['WS001', 'MGR045'])\n - Full or partial user names (e.g., ['John Smith', 'Sarah']) — these will be resolved to IDs\n - A mix of both (e.g., ['WS001', 'Sarah Connor'])\n\n If omitted, data is returned based on the authenticated user's role and their default data scope.\n Examples: ['WS001'], ['WS001', 'MGR045'], ['John Smith'], ['John Smith', 'WS002']"
},
"exclude_fillers": {
"anyOf": [
{
"type": "object",
"additionalProperties": true
},
{
"type": "null"
}
],
"title": "Exclude Fillers",
"default": null,
"description": "Dictionary of exclusion filters (e.g. {'rep_type': '!BUYING_UNIT'})"
},
"observation_end": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Observation End",
"default": null,
"description": "End date for observations in YYYY-MM-DD format. Example: '2025-12-31'."
},
"observation_start": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Observation Start",
"default": null,
"description": "Start date for observations in YYYY-MM-DD format. Example: '2020-01-01'."
},
"source_resource_id": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Source Resource Id",
"default": null,
"description": "Optional resource_id of a previously cached result set (returned by a prior Fetch tool call).\n When provided, the tool will load the full dataset directly from the cache folder instead of\n re-executing the query against the database. Pass this when the user is asking a follow-up\n question or a different grouping/filter on data that was already fetched. \n Also, use this, when one tool output is an input for another tool.\n "
},
"additional_display_fields": {
"anyOf": [
{
"type": "array",
"items": {
"type": "string"
}
},
{
"type": "null"
}
],
"title": "Additional Display Fields",
"default": null,
"description": "List of additional fields to display (e.g. ['firm_name', 'rep_name'])"
},
"optional_additional_filters": {
"anyOf": [
{
"type": "object",
"additionalProperties": true
},
{
"type": "null"
}
],
"title": "Optional Additional Filters",
"default": null,
"description": "Dictionary of additional filters not covered by other fields"
}
},
"description": "Fetch time-series data points for a FRED series."
}
},
"title": "GetFredSeriesDataArguments",
"properties": {
"params": {
"$ref": "#/$defs/FredSeriesDataParams",
"default": null
}
}
}No endpoints wrapped at confidence ≥ 0.50.
Parent server
Fintel Discovery — Financial Intelligence for AI Agents
1/7 registries