FRED MCP server for AI agents

Let Claude, ChatGPT or your own agent read FRED: 6 typed functions through one MCP server. No FRED API key needed.

Functions
6
Sign-in
Not needed
Works with
MCP, HTTP, Node, Python

Connect

Just FRED

An MCP server for FRED alone, with one tool per function. Paste it into Claude, ChatGPT, Cursor or any MCP client as a remote server.

https://api.bowmark.ai/mcp/site/fred
Every site

One MCP server for FRED and every other site Bowmark covers. Your agent looks up what it needs and calls it.

https://api.bowmark.ai/mcp
Set it up in your client

Both need a Bowmark API key. The quickstart gets you one and a first result in a few minutes.

Functions

Open a function to see its arguments, what it returns and how to call it.

Read 6
  • browseCategoryBrowses FRED's category tree the way fred.stlouisfed.org/categories does.

    Arguments

    NameTypeRequired
    categoryIdnumberNo

    Returns fredCategory

    interface fredSeries {
      id: string;
      title: string;
      units: string;
      unitsShort: string;
      frequency: string;
      frequencyShort: string;
      seasonalAdjustment: string;
      seasonalAdjustmentShort: string;
      observationStart: string;
      observationEnd: string;
      lastUpdated: string;
      popularity: number | null;
      notes: string | null;
    }
    
    interface fredCategoryRow {
      id: number;
      name: string;
      parentId: number;
    }
    
    interface fredCategory {
      id: number;
      name: string;
      parentId: number;
      children: fredCategoryRow[];
      series: fredSeries[];
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/fred/browseCategory

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.fred.browseCategory();
  • getSeriesInfoReads the metadata for one known series id.

    Arguments

    NameTypeRequired
    seriesIdstringYes

    Returns fredSeries

    interface fredSeries {
      id: string;
      title: string;
      units: string;
      unitsShort: string;
      frequency: string;
      frequencyShort: string;
      seasonalAdjustment: string;
      seasonalAdjustmentShort: string;
      observationStart: string;
      observationEnd: string;
      lastUpdated: string;
      popularity: number | null;
      notes: string | null;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/fred/getSeriesInfo

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.fred.getSeriesInfo("GDPC1");
  • getSeriesObservationsReads the actual numbers for a FRED series.

    Arguments

    NameTypeRequired
    argsstring | { seriesId: string; from?: string; to?: string; units?: string; frequency?: string; aggregationMethod?: string }Yes

    Returns fredObservations

    interface fredObservation {
      date: string;
      /** null where FRED holds no observation for that period, a market holiday in a
       * daily series, or the first year of a year-over-year transform. */
      value: number | null;
    }
    
    interface fredObservations {
      seriesId: string;
      /** The transform FRED reports having applied: "lin" (none), "pc1", "pch", … */
      units: string;
      observationStart: string | null;
      observationEnd: string | null;
      /** null: the public CSV has no vintage envelope. */
      realtimeStart: string | null;
      realtimeEnd: string | null;
      count: number;
      observations: fredObservation[];
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/fred/getSeriesObservations

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.fred.getSeriesObservations("GDPC1");
  • listReleasesLists FRED's economic data releases.

    Arguments

    NameTypeRequired
    args{ releaseId?: number; from?: string; to?: string }No

    Returns fredRelease[]

    interface fredReleaseDate {
      date: string;
      time: string | null;
      released: boolean;
    }
    
    interface fredRelease {
      id: number;
      name: string;
      url: string;
      dates: fredReleaseDate[] | null;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/fred/listReleases

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.fred.listReleases();
  • listSourcesLists the agencies and organizations that originate FRED's data.

    Arguments

    NameTypeRequired
    args{ sourceId?: number }No

    Returns fredSource[]

    interface fredSource {
      id: number;
      name: string;
      url: string;
      releases: { id: number; name: string; url: string }[] | null;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/fred/listSources

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.fred.listSources();
  • searchSeriesFinds the economic data series that match a search text.

    Arguments

    NameTypeRequired
    argsstring | { query: string; limit?: number }Yes

    Returns fredSeries[]

    interface fredSeries {
      id: string;
      title: string;
      units: string;
      unitsShort: string;
      frequency: string;
      frequencyShort: string;
      seasonalAdjustment: string;
      seasonalAdjustmentShort: string;
      observationStart: string;
      observationEnd: string;
      lastUpdated: string;
      popularity: number | null;
      notes: string | null;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/fred/searchSeries

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.fred.searchSeries("gdp");

Use it from code