# FRED Economic Data

> GDP, unemployment, CPI, interest rates, and 800K+ economic time series from the Federal Reserve

- name: com.olyport/fred
- version: 1.0.0
- connection class: R0 (autonomous)
- trust: 72/100 flags: no-repository
- quality: 79/100 (good)
- owner: not claimed
- descriptor: https://api.protogrid.dev/v1/servers/com.olyport%2Ffred
- tools: https://api.protogrid.dev/v1/servers/com.olyport%2Ffred/tools

**An agent can connect right now, no human step.** Remote endpoint, no authentication, reachable on the last probe.

## Connection (mcpServers)

```json
{
  "mcpServers": {
    "fred": {
      "type": "http",
      "url": "https://mcp.olyport.com/fred/mcp"
    }
  }
}
```


## Trust

- hygiene: 80
- liveness: 100
- freshness: 45
- provenance: 55
- drivers: +dns-namespace +website +reachable +uptime-100% -stale-200d -no-repository
- Derived from observable signals (official registry feed and our own credential-free probes); no code audit performed.

## Quality 79/100 (good)

### protocol: 75 (weight 25)

- warn `protocol.modern`: newest supported version is 2025-11-25; 2026-07-28 not supported, older versions are deprecated until 2027-07-28
- n/a `protocol.stateless`: only applies to 2026-07-28 servers
- pass `protocol.transport`: streamable HTTP
- n/a `protocol.list_ttl`: only applies to 2026-07-28 servers

### authorization: n/a (weight 15)

- n/a `auth.prm`, `auth.as_metadata`, `auth.cimd`: no remote uses OAuth
- n/a `auth.secret_in_url`: no templated URL

### tool hygiene: 71 (weight 30)

- pass `tools.descriptions`: every tool has a description
- pass `tools.description_length`: descriptions are concise
- pass `tools.schemas`: every tool has an object input schema
- fail `tools.annotations`: no tool declares readOnlyHint or destructiveHint, so clients cannot tell safe calls from risky ones
- fail `tools.directory_hints`: no tool declares all four of readOnlyHint, destructiveHint, idempotentHint and openWorldHint; missing: get_category_series (readOnlyHint, destructiveHint, idempotentHint, openWorldHint); get_release_dates (readOnlyHint, destructiveHint, idempotentHint, openWorldHint); get_series_observations (readOnlyHint, destructiveHint, idempotentHint, openWorldHint); …
- pass `tools.token_cost`: about 1,018 tokens to load every tool
- pass `tools.api_dump`: tools are not a one-to-one API dump

### stability: 100 (weight 15)

- pass `stability.changes`: no tool changes in 30 days
- pass `stability.rug_pull`: no tool changed its meaning under the same name

### dependencies: n/a (weight 15)

- n/a `deps.known_vulns`, `deps.mcp_sdk_version`, `deps.resolvable`: no npm or PyPI package

- tools: 5, about 1,018 tokens to load them all
- tool set hash: 208cd05bd5f24e077d2056184e343cc8
- badge: [![protogrid quality](https://protogrid.dev/badge/com.olyport/fred.svg)](https://protogrid.dev/servers/com.olyport/fred)
- Checks run on what our credential-free, read-only probes observe; tools are never called and no code audit is performed.

### Tool changes

_No tool definition changes recorded._

## Remotes

- https://mcp.olyport.com/fred/mcp (streamable-http, auth none, reachable true, uptime30d 1)

## Packages

_none_

## Tools (5)

- `get_category_series`: 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).
    
- `get_release_dates`: 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).
    
- `get_series_info`: 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').
    
- `get_series_observations`: 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).
    
- `search_series`: 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).
    
