FRED в MCP: экономические данные США и мира, публикации и пересмотры в любом AI-агенте

💡 Без установки? Используйте cloud.anythingmcp.com напрямую. Войдите, нажмите Connectors → FRED, вставьте учётные данные, создайте MCP API key, и готово. Без Docker, без git clone, без локального сервера.

FRED

Экономические данные FRED (ФРБ Сент-Луиса): поиск примерно по 800 000 рядам США и других стран (ВВП, инфляция, безработица, ставки, валютные курсы), значения с преобразованиями, публикации и их календарь, история пересмотров. Только чтение, бесплатный API-ключ.

Настройка

Настройка занимает около 2 минут и бесплатна. Нужна бесплатная учётная запись FRED.

1. Войдите или создайте бесплатную учётную запись на https://fredaccount.stlouisfed.org.
2. Откройте API Keys (https://fredaccount.stlouisfed.org/apikeys), запросите ключ и опишите назначение одним предложением. Ключ представляет собой строку из 32 символов в нижнем регистре и выдаётся сразу.
3. Вставьте его в FRED_API_KEY. Он передаётся как параметр запроса api_key.
4. Установите коннектор; проверка читает корневую категорию через fred_get_category. Затем попробуйте fred_get_observations с UNRATE и limit 1, чтобы получить последний уровень безработицы в США.

Поиск ряда: fred_search_series ищет по названиям, единицам, примечаниям и тегам; order_by popularity ставит основные ряды первыми, а search_type series_id сравнивает идентификаторы, в том числе с подстановкой вроде DGS*. Известные идентификаторы: GDP, GDPC1 (реальный ВВП), UNRATE, PAYEMS (занятость вне сельского хозяйства), CPIAUCSL, CPILFESL (базовый CPI), PCEPI, FEDFUNDS, DGS10, T10Y2Y, MORTGAGE30US, SP500, VIXCLS, DCOILWTICO, DEXUSEU (долларов США за евро), M2SL. Можно также пройти по дереву категорий от корневой категории 0, вывести ряды одной публикации или сочетать теги вроде gdp;germany в fred_list_tag_series.

Что он читает: значения ряда, от новых к старым (по умолчанию последние 1000 или период через observation_start и observation_end); метаданные ряда (единицы, частота, сезонная корректировка, примечания, последнее обновление) с его категориями, публикацией и тегами; категории и их ряды; статистические публикации, их ряды и даты выхода, а также календарь всех публикаций, включая предстоящие даты; источники данных и их публикации; теги; недавно обновлённые ряды; и даты версий, когда ряд публиковался или пересматривался. Данные поступают более чем из 100 источников, таких как BEA, BLS, Совет управляющих ФРС, Бюро переписи, ОЭСР, МВФ и Eurostat.

Преобразования: units превращает уровни в изменение, процентное изменение, процентное изменение к прошлому году (pc1), сложные годовые темпы или натуральный логарифм. frequency с aggregation_method (среднее, сумма или конец периода) агрегирует данные к более низкой частоте, например дневные ставки в месячные средние; выше собственной частоты ряда она быть не может.

Пересмотры: fred_list_vintage_dates показывает, когда ряд публиковался или пересматривался (ALFRED). fred_get_observations с realtime_start и realtime_end, равными одной дате версии, показывает данные такими, какими они были известны в тот день, например первую оценку квартального ВВП.

Форматы данных: значения приходят строками в единицах ряда, поэтому ИИ сверяет единицы и сезонную корректировку, прежде чем сравнивать два ряда. Значение "." означает отсутствие наблюдения на эту дату, например в праздник. Даты в формате YYYY-MM-DD и обозначают начало периода (2026-04-01 для второго квартала 2026 года). Месячные и квартальные ряды выходят с задержкой, поэтому ИИ называет дату последнего наблюдения, а не сегодняшнюю. Окно fred_list_series_updates задаётся как YYYYMMDDHhmm по центральному времени США. ИИ ссылается на FRED и на первоисточник из примечаний ряда; некоторые ряды защищены авторским правом источника, и примечания об этом говорят.

Только чтение: все инструменты только читают, поэтому подтверждать нечего и ни один инструмент не отключён при установке.

Лимиты: до 120 запросов в минуту на ключ. Списки листаются через limit и offset.

Частые ошибки: FRED отвечает 400 с error_message, где названа проблема: "api_key is not registered" при неверном или отсутствующем ключе, "The series does not exist" при неизвестном идентификаторе или недопустимый параметр, например частота выше собственной частоты ряда. 429 означает, что лимит исчерпан: подождите минуту.

Коннектор не охватывает карты и региональные границы GeoFRED, массовую выгрузку FRED v2 и группы рядов.

Предварительные требования: FRED_API_KEY

Локальная установка коннектора

curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d

Откройте http://localhost:3000/connectors/store, выберите FRED и введите переменные, перечисленные в Предварительных требованиях.

Доступные инструменты

Примеры запросов

• «Какой последний уровень безработицы в США по данным FRED и к какому месяцу он относится?»
• «Покажи инфляцию CPI в США год к году за последние 24 месяца.»
• «Сравни доходность 10-летних и 2-летних казначейских облигаций США за последний год в виде месячных средних.»
• «Когда запланирована следующая публикация Employment Situation?»
• «Каким было первое опубликованное значение реального ВВП США за первый квартал 2026 года и как его пересматривали с тех пор?»

Следующие шаги

• Подключить к Claude
• Подключить к ChatGPT