Усильте своих ИИ-агентов финансовыми данными институционального уровня
Мы рады сообщить, что Financial Modeling Prep (FMP) теперь поддерживает Model Context Protocol (MCP). Новая интеграция позволяет подключить более 70 000 точек данных FMP по акциям напрямую к ИИ-агентам (таким как Claude, Cursor или собственные боты), не написав ни одной строки кода-обёртки для API.
Что такое Model Context Protocol (MCP)?
Представьте MCP как «порт USB-C» для искусственного интеллекта.
До появления MCP, чтобы дать ИИ доступ к конкретному набору данных (календарю, базе данных или котировкам акций), приходилось писать отдельный код, «склеивающий» их между собой. В результате для каждого нового инструмента возникала своя запутанная интеграция.
MCP меняет это. Это открытый стандарт (представленный Anthropic), который даёт ИИ-приложениям («клиентам») универсальный способ подключаться к внешним источникам данных («серверам»).
- Стандартизация: как только источник данных «говорит» на MCP, любой ИИ-агент мгновенно понимает, как с ним работать.
- Обнаруживаемость: ИИ автоматически узнаёт, какие инструменты доступны (например, «Получить цену акции», «Получить баланс»), и вам не нужно вставлять документацию API в чат.
В чём ценность?
Для разработчиков и финансовых аналитиков MCP решает три ключевые проблемы:
- Ноль «связующего кода»: не нужно писать Python-скрипты, чтобы получать данные, разбирать JSON и передавать их в LLM. MCP-сервер получает данные автоматически.
- Более умные агенты: вместо того чтобы выдумывать финансовые данные, ваш ИИ-агент получает прямой доступ к базе данных FMP в реальном времени. Он может «вызвать» нужный инструмент именно тогда, когда нужно ответить на вопрос.
- Экономия токенов: больше не нужно вставлять в промпт объёмную документацию API, чтобы научить ИИ работать с FMP. Протокол эффективно передаёт определения инструментов, сохраняя контекстное окно для самого анализа.
Представляем MCP-сервер FMP
Наш новый MCP-сервер превращает все традиционные REST-эндпоинты в готовые к использованию ИИ-инструменты.
Когда вы подключаете ИИ-агента к MCP-серверу FMP:
- Мгновенный доступ к инструментам: ИИ сразу получает возможность «вытягивать» котировки в реальном времени, историческую отчётность и технические индикаторы.
- Бесшовная интеграция: каждый запрос ИИ просто учитывается в ваших текущих лимитах API — никаких новых аккаунтов и сложных расчётов.
- Понимание контекста: ИИ точно знает, какие параметры обязательны (например, «Тикер», «Дата», «Период»), поскольку MCP-сервер предоставляет строгие определения.
Пошаговое руководство по подключению
MCP-сервер FMP — удалённый сервер, поэтому ничего не нужно устанавливать или размещать. По возможности используйте официальный коннектор в Claude или ChatGPT; любой другой MCP-клиент подключается по URL подключения с вашим API-ключом.
Предварительные требования
- Активный API-ключ FMP (получить здесь).
- MCP-совместимый клиент (например, Claude Desktop, Cursor или собственный скрипт).
Официальные коннекторы
У FMP есть официальные коннекторы для Claude и ChatGPT. Добавьте FMP из каталога коннекторов соответствующего продукта (найдите Financial Modeling Prep) и войдите с помощью аккаунта FMP; вставлять API-ключ не нужно. Чтобы подключиться с API-ключом, используйте URL подключения ниже.
Сервер также является ресурсом, защищённым OAuth 2.0, — именно так входят официальные коннекторы. OAuth-клиенты должны быть заранее зарегистрированы у нас — по client ID или по URL документа Client ID Metadata Document (CIMD); открытой динамической регистрации клиентов нет. Если вы хотите использовать OAuth в собственном приложении, свяжитесь с нами, указав данные вашего клиента, и мы добавим вас в список разрешённых.
URL для подключения
Это «волшебная ссылка», которая понадобится вам для всех интеграций:
Клиенты, в которых можно задавать заголовки, могут вместо этого подключаться к https://financialmodelingprep.com/mcp и отправлять X-API-Key: YOUR_API_KEY. По возможности используйте этот способ: так ключ не попадает в URL и логи.
Ключ, который всё ещё является шаблонной заглушкой (например, ${FMP_API_KEY} или <your-key>), отклоняется с кодом 401 уже при подключении, а не открывает сессию, в которой каждый вызов завершается ошибкой.
Параметры подключения
- Транспорт: только Streamable HTTP.
- Сессии истекают после 15 минут бездействия; запрос в истёкшей сессии получает
404, и клиент должен заново выполнить инициализацию (большинство клиентов делают это автоматически). - Тайм-ауты: вызовы инструментов дольше 25 секунд возвращают ошибку. Сузьте запрос (меньше символов, более короткий диапазон дат, меньший
limit) и повторите попытку.
A. Как подключиться к Claude (веб и десктоп)
- Откройте Настройки и выберите раздел Connectors.
- Выберите Add custom connector и вставьте URL подключения FMP в поле «Remote MCP Server URL». Введите любое имя в поле «Name» и нажмите Add.
- Начните новый чат в Claude — инструменты FMP будут сразу доступны. Просто спросите: «Сравни коэффициент P/E Apple и Microsoft за последние 5 лет».
B. Как подключиться к Cloudflare Workers AI
- Перейдите в Cloudflare Workers AI Playground.
- Найдите раздел MCP Servers в левой боковой панели.
- Вставьте URL подключения FMP (см. выше) в поле «Server URL».
- Нажмите Add.
- Доступные инструменты FMP появятся в списке. Теперь можно дать ИИ команду: «Используй инструмент FMP, чтобы найти последнюю отчётность NVDA».
C. Как подключиться через Python
Если вы создаёте собственного агента на Python, можно использовать стандартные MCP-библиотеки. Вот простой пример с FastMCP:
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
import asyncio
from fastmcp import Client
from fastmcp.client.transports import StreamableHttpTransport
transport = StreamableHttpTransport(
"https://financialmodelingprep.com/mcp",
headers={"X-API-Key": "YOUR_API_KEY"},
)
async def main():
async with Client(transport) as client:
tools = await client.list_tools()
print([t.name for t in tools])
# ['ESG', 'analyst', 'calendar', 'chart', 'company', ...]
result = await client.call_tool("quote", {"endpoint": "quote", "symbol": "AAPL"})
print(result.content[0].text)
# [{"symbol": "AAPL", "name": "Apple Inc.", "price": ..., ...}]
asyncio.run(main())Структура инструментов
Инструменты сгруппированы по категориям данных, а не по одному на эндпоинт: так список инструментов остаётся компактным и укладывается в ограничения некоторых распространённых клиентских приложений. В зависимости от тарифа доступно до 28 инструментов, например quote, statements, company, calendar, secFilings, technicalIndicators и news; каждый охватывает набор связанных эндпоинтов Stable API.
Все инструменты принимают входные данные одной и той же формы:
- endpoint (обязательный): вызываемый эндпоинт внутри категории, в виде enum. Например,
quoteпринимаетquote,quote-short,batch-quote,aftermarket-quoteи другие;statementsпринимаетincome-statement,balance-sheet-statement,cashflow-statementи другие. - Параметры эндпоинта (необязательные в схеме): объединение параметров всех эндпоинтов инструмента, например
symbol,from_date,to_date,periodиlimit.from_dateиto_dateсоответствуют REST-параметрамfromиto. Поскольку одна схема обслуживает несколько эндпоинтов, в описании инструмента перечислен каждый эндпоинт с обязательными параметрами, отмеченными*. - limit: если эндпоинт поддерживает
limit, а значение не передано, по умолчанию используется 50 или лимит вашего тарифа, если он меньше.
Пример аргументов tools/call:
1
2
3
4
5
6
7
8
9
{
"name": "statements",
"arguments": {
"endpoint": "income-statement",
"symbol": "AAPL",
"period": "annual",
"limit": 5
}
}- Список инструментов по тарифу:
tools/listвозвращает только эндпоинты, доступные вашему ключу, и не включает инструменты без таких эндпоинтов. Смена тарифа вступает в силу со следующей сессии. - Результаты: JSON-ответ эндпоинта, возвращаемый одним текстовым блоком контента. Пустой результат не считается ошибкой: он возвращается как
[]или как объектnot_found, если вы передали идентификатор, напримерsymbol. - Ошибки: возвращаются как результаты инструмента с
isError: trueи сообщением, в котором указан инструмент и, где уместно, эндпоинт: отсутствует обязательный параметр, ограничение тарифа (с перечнем тарифов, включающих эндпоинт), достигнут лимит запросов, API-ключ отклонён или истекло время ожидания.
Сценарии использования: что можно построить?
- Чат-бот «младший аналитик»: стандартизированный чат-интерфейс, в котором портфельные менеджеры задают вопросы на естественном языке («Покажи динамику соотношения долга к капиталу Tesla и Ford») и получают точные графики и ответы, подтверждённые данными.
- Автоматизированный due diligence: агент, который сам «просыпается», когда акция падает на 5 %, получает через MCP свежие новости и отчёты SEC, кратко описывает причину и отправляет вам отчёт по электронной почте.
- Инвестиционные исследования в реальном времени: подключите FMP к IDE, например Cursor, чтобы получать актуальный финансовый контекст прямо в редакторе кода во время разработки финтех-приложений.
Готовы начать?
Получите API-ключ и начните создавать более умных финансовых агентов уже сегодня.