parsimony-fred 0.5.0

FRED (Federal Reserve Economic Data) connector for the parsimony framework

parsimony-fred

FRED (Federal Reserve Economic Data) connector for the parsimony framework.

Part of the parsimony-connectors monorepo. Distributed standalone on PyPI as parsimony-fred.

What it does

Once installed, this plugin is discovered automatically and exposes the following connectors:

Connector	Kind	Tool-tagged	Description
fred_search	connector	yes	Keyword search across FRED series (id, title, units, frequency).
fred_fetch	connector	—	Fetch observation-level data for a FRED series by series_id.

Install

pip install parsimony-fred

Pulls in parsimony-core>=0.4,<0.5 automatically.

Configuration

export FRED_API_KEY="<your-key>"

Get a key at https://fred.stlouisfed.org/docs/api/api_key.html.

Verify discovery:

python -c "from parsimony import discover; print([p.name for p in discover.iter_providers()])"

Quick start

import asyncio
from parsimony_fred import CONNECTORS

async def main():
    connectors = CONNECTORS.bind_env()
    result = await connectors["fred_fetch"](series_id="UNRATE")
    print(result.data.head())

asyncio.run(main())

For multi-plugin composition:

from parsimony import discover
connectors = discover.load_all().bind_env()

To expose tool-tagged connectors over MCP, install the standalone server: https://github.com/ockham-sh/parsimony-mcp.

Catalog discovery

FRED ships a native search endpoint, so this plugin does not publish an embedded catalog. Use fred_search for keyword discovery — it calls /series/search directly against the FRED API.

Development

uv sync --extra dev
uv run pytest

Release-blocking conformance test: uv run pytest tests/test_conformance.py.

Provider

• Homepage: https://fred.stlouisfed.org
• API docs: https://fred.stlouisfed.org/docs/api/fred/

License

Apache-2.0 — see LICENSE.