FRED — Федеральные резервные экономические данные

Хранилище данных ФРС Сент-Луиса: более 800 000 экономических временных рядов, охватывающих процентные ставки, инфляцию, занятость, ВВП, денежную массу, обменные курсы и показатели на уровне мегаполисов. Самый авторитетный и постоянно обновляемый источник макроэкономических и монетарных данных США — используется экономистами, политиками и журналистами.

Часть Pipeworx — MCP-шлюза, соединяющего ИИ-агентов с более чем 1476 живыми источниками данных.

Почему это важно для ИИ-агентов

Большинство макроэкономических вопросов вида «каково текущее значение X» сводятся к ряду FRED. Агент, знающий идентификатор ряда, может ответить фактическим текущим значением, а не снимком из обучающих данных. Распространённые примеры:

• 30-летняя ставка по ипотеке → MORTGAGE30US

• Ставка по федеральным фондам → DFF

• ИПЦ (все товары) → CPIAUCSL

• Уровень безработицы → UNRATE

• Доходность 10-летних казначейских облигаций → DGS10

• Начало строительства жилья → HOUST

• Индекс цен на жилье Case-Shiller → CSUSHPISA

Если ваш агент отвечает на вопрос о макроэкономическом состоянии США, правильный шаблон: fred_search (найти нужный ряд) → fred_series_info (подтвердить единицы и частоту) → fred_get_series (получить значения).

Related MCP server: FRED Economic MCP Server

Аутентификация

FRED требует API-ключ. Он бесплатен на https://fred.stlouisfed.org/docs/api/api_key.html — занимает 30 секунд, без оплаты и без страха лимитов.

Передавайте через _apiKey при каждом вызове:

fred_get_series({
  series_id: "MORTGAGE30US",
  _apiKey: "your-fred-api-key"
})

Или подпишитесь на Housing Vertical, который управляет ключом за вас.

Частота обновления

Pipeworx кэширует ответы FRED с TTL, соответствующими этим ритмам — см. кэширование и свежесть.

Цитируемый URI

Встраивайте в свой вывод для стабильных цитат:

pipeworx://fred/series/{series_id}
pipeworx://fred/series/{series_id}/observations

Другие агенты (и resources/read) могут разрешать их в текущее значение ряда.

Частые ошибки

• Винтажи: FRED сохраняет исторические «винтажи» (данные, как они были представлены в момент времени T). По умолчанию вызовы инструментов получают последнюю пересмотренную серию. Передавайте realtime_start и realtime_end для запросов на определённую дату.

• Агрегация частоты: параметр frequency приводит к другой периодичности (например, дневная → среднемесячная). По умолчанию используется собственная частота ряда.

• Преобразование единиц: параметр units вычисляет производные ряды во время запроса (pch для процентного изменения, pca для сложной годовой ставки и т.д.). Не вычисляйте это на стороне клиента; позвольте FRED сделать это.

• Переименование рядов: иногда ФРС прекращает использование ряда и создаёт преемника. Старые идентификаторы возвращают ошибки. fred_search — путь восстановления.

Быстрый старт

Добавьте в ваш MCP-клиент (Claude Desktop, Cursor, Windsurf и т.д.):

{
  "mcpServers": {
    "fred": {
      "url": "https://gateway.pipeworx.io/fred/mcp"
    }
  }
}

Что на самом деле предоставляет эта конечная точка

tools/list на https://gateway.pipeworx.io/fred/mcp возвращает инструменты из таблицы выше плюс общие мета-инструменты Pipeworx — ask_pipeworx, discover_tools, search_within, remember/recall и остальной набор шлюза. Поэтому количество инструментов, которое вы видите, больше, чем в этой таблице: конечная точка одного пакета в настоящее время перечисляет около 30 общих инструментов наряду с собственными инструментами пакета. Ответ initialize соединения указывает точную область действия и является авторитетным ответом для данного дня.

Это сделано намеренно, а не случайное мультиплексирование. Мета-инструменты позволяют ограниченному соединению ответить на вопрос, который этот пакет не покрывает — через ask_pipeworx, который маршрутизирует по всему каталогу — без добавления второго MCP-сервера. В настоящее время нет способа подключить конечную точку пакета без них; если дополнительные схемы стоят вам больше контекста, чем стоит маршрутизация, подключитесь к полному шлюзу один раз, а не к нескольким конечным точкам пакетов.

Или подключитесь к полному шлюзу Pipeworx, чтобы получить инструменты всех пакетов, перечисленные напрямую, а не только этого:

{
  "mcpServers": {
    "pipeworx": {
      "url": "https://gateway.pipeworx.io/mcp"
    }
  }
}

Оба URL-адреса ведут к одному шлюзу и тем же 1476+ источникам данных. Единственное отличие — какие инструменты пакета перечислены напрямую; ask_pipeworx достигает всех из них с любого из них.

Использование с ask_pipeworx

Вместо прямого вызова инструментов вы можете задавать вопросы на простом английском — это работает как на конечной точке пакета выше, так и на полном шлюзе:

ask_pipeworx({ question: "your question about Fred data" })

Шлюз выбирает нужный инструмент и автоматически заполняет аргументы.

Дополнительно

• Документация и руководства

• pipeworx.io

Лицензия

MIT