FinancialMD для AI-агентов
FinancialMD — финансовый терминал для агентов, изначально созданный для AI. Он предоставляет финансовую отчетность, построенную на основе документов, поданных в SEC. Каждое число содержит подтверждение, ведущее обратно к документу, поданному в SEC, и каждое чтение можно выполнить на прошлую дату, поэтому агент может ссылаться на свои утверждения и проводить бэктест без look-ahead.
Шаг 1. Подключите сервер MCP
Сервер MCP находится на https://mcp.financial.md/mcp (Streamable HTTP, без состояния). У него есть 57 инструмента только для чтения. Вход в систему необязательный: без токена он отвечает в пределах ежедневных лимитов без ключа.
Claude Code:
claude mcp add --transport http financial-md https://mcp.financial.md/mcpКлиенты, которые читают конфигурацию JSON (Cursor, VS Code, Windsurf и другие):
{
"mcpServers": {
"financial-md": { "type": "http", "url": "https://mcp.financial.md/mcp" }
}
}В Claude или ChatGPT добавьте тот же URL как пользовательский коннектор. Карта сервера находится по адресу mcp.financial.md/.well-known/mcp.json, а метаданные OAuth — по адресу mcp.financial.md/.well-known/oauth-protected-resource.
Начните с company_lookup, затем snapshot_as_of (все три отчета и коэффициенты, известные на определенную дату (point-in-time), в одном вызове) или financials_standardized. Используйте verify_value, чтобы проверить число, которое вы нашли где-то еще.
Шаг 2. Выполните вызов API без ключа
HTTP API не требует ни учетной записи, ни ключа. Этот вызов возвращает последние пять годовых отчетов Apple о движении денежных средств, включая свободный денежный поток:
curl "https://api.financial.md/v1/company/financials/cash_flow/standardized?company=ticker:AAPL&period_type=annual&limit=5"Каждое число — это объект значения с proof.accession, proof.form, proof.filed и proof.source_url (документ на sec.gov). Добавьте as_of=2024-06-30, чтобы увидеть то, что было известно на эту дату. Сверьте число с документом, поданным в SEC:
curl -X POST "https://api.financial.md/v1/verify" -H "content-type: application/json" \
-d '{"company":"ticker:AAPL","concept":"income_statement_total_revenues","period":"FY2024","value":391035000000}'Без ключа каждый IP-адрес получает 10 тарифицируемых вызовов в день (ratios, screen, verify), 1,000 обращений к слою документов, поданных в SEC, и 1,000 обращений к метаданным. Каждый ответ содержит заголовки RateLimit-*; ответ 429 содержит Retry-After, а в теле каждой ошибки перечислены способы решения.
Шаг 3. Оплата за вызов
agent.financial.md обслуживает те же маршруты для агентов, которые платят за вызов через x402 (USDC на Base), без аккаунта. Платный маршрут там отвечает кодом 402 с ценой в заголовке PAYMENT-REQUIRED; подпишите платеж и отправьте вызов снова с заголовком PAYMENT-SIGNATURE. В теле 402 также указан хост без ключа, где за тот же маршрут не взимается плата в пределах ежедневных лимитов.
Цена каждого маршрута указана в pricing.json и в поле x-price документа OpenAPI. Применяется цена из ответа 402. За вызов, завершившийся ошибкой, плата не взимается.
Файлы для агентов
| Файл | Что это такое |
|---|---|
| openapi.json | OpenAPI 3.1. Каждая операция имеет описание и примерный запрос с реальным тикером |
| llms.txt | Краткое руководство: хосты, идентификаторы компаний, объект значения, чтение на определенную дату (point-in-time), лимиты |
| llms-full.txt | Всё в одном текстовом файле: каждый маршрут, формула коэффициента и рецепт |
| skill.md | Навык агента с рецептами в один вызов |
| skills.zip | Навыки агента (SKILL.md), которые вызывают инструменты MCP, в одном zip |
| pricing.json | Цены за вызов, дневные лимиты и статус оплаты |
| mcp.json | Карточка MCP-сервера: инструменты, аутентификация и документы |
| server.json | Запись в реестре MCP |
| agent.json | Единый индекс всех конечных точек и документов выше |
На что может опираться агент
- У каждого числа есть источник: accession number документа, поданного в SEC, форма, дата подачи, тег XBRL и ссылка на документ на sec.gov.
GET /proof/{id}показывает исходные факты, стоящие за ним. - На определенную дату (point-in-time):
known.fromиknown.toпоказывают, когда каждое значение было последним числом из поданного документа.as_of,original=trueиhistory=trueпозволяют читать прошлое без заглядывания вперед и показывают пересчеты. - Краткие ответы: вызов отчета возвращает только запрошенные периоды; результаты инструментов MCP начинаются с однострочного резюме перед структурированными данными.
- Тикер, CIK или имя:
company=ticker:AAPL,company=cik:320193, илиGET /v1/companies?q=Apple. - Покрытие: компании, подающие документы в SEC и торгующиеся сегодня на бирже США; стандартизированные отчеты для компаний, использующих US GAAP. Только информация, не инвестиционная рекомендация.