Перейти к содержанию

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.jsonOpenAPI 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. Только информация, не инвестиционная рекомендация.