us-gov-data-mcp

MCP-сервер для данных правительства США. Спросите своего ИИ-ассистента, какие федеральные контракты истекают или у каких публичных компаний была самая большая выручка в прошлом году — и получите ответы, которые можно проверить по официальным записям правительства.

Построен на API USAspending Казначейства США и данных EDGAR XBRL SEC. Без скрейпинга, без API-ключа, без аккаунта, без персональных данных.

Зачем это существует

Оба этих источника публикуют всё, но почти ничего не позволяют запрашивать.

usaspending.gov не умеет искать по дате окончания контракта. Но когда срок исполнения федерального контракта истекает, работу обычно приходится выставлять на повторный конкурс — и эти повторные конкурсы являются возможностями с наибольшей вероятностью успеха в госзакупках, видными в открытых данных за месяцы до появления любого извещения.

sec.gov отдаёт отчётности по одной компании за раз. На сайте нет способа узнать, у каких публичных компаний выручка превысила 100 миллиардов долларов или у кого больше всего денежных средств. API frames SEC может ответить на это по всем ~5 800 эмитентам одним запросом, если вы уже знаете тег XBRL и формат периода.

Этот сервер отвечает на вопросы, на которые эти сайты ответить не могут.

Related MCP server: sec-edgar-mcp

Четыре инструмента

find_expiring_contracts — повторные конкурсы

Федеральные контракты, которые скоро будут выставлены на повторные торги, с указанием действующего подрядчика и оставшихся дней. expiring_after_days задаёт ваш запас времени на подготовку заявки, потому что контракт, истекающий на следующей неделе, бесполезен для подготовки.

{
  "days_until_expiry": 120,
  "recipient": "PERATON ENTERPRISE SOLUTIONS LLC",
  "amount_usd": 682369225.00,
  "awarding_agency": "General Services Administration",
  "verify_url": "https://www.usaspending.gov/award/..."
}

search_federal_contracts

Заключённые контракты по ведомству, ключевому слову, дате или сумме в долларах. Кто выигрывает федеральные заказы, на что тратит ведомство, история конкурента.

screen_public_companies

Ранжирует все публичные компании США по любому отчётному финансовому показателю.

«У каких компаний выручка превысила 200 миллиардов долларов в 2023 году?»

{ "company": "Walmart Inc.", "value": 648125000000, "unit": "USD",
  "period_end": "2023-12-31", "period_type": "annual",
  "verify_url": "https://www.sec.gov/Archives/edgar/data/104169/..." }

company_financial_history

История одного показателя одной компании — выручка, чистая прибыль, активы, денежный поток — без дубликатов, с типом формы и датой подачи по каждой записи.

Всё проверяемо

Каждая запись содержит verify_url на государственный документ, из которого она взята. Откройте его и сравните.

Это особенно важно, когда в цикле участвует ИИ: когда ассистент сообщает сумму в долларах, вы должны иметь возможность сверить её с источником, а не доверять цепочке. Если значение когда-либо разойдётся с официальной записью — это ошибка, пожалуйста, откройте issue.

Три ловушки, которые этот сервер обрабатывает за вас

Сырые данные SEC вводят в заблуждение тремя конкретными способами, каждый из которых незаметен — вы получаете правдоподобное неверное число, а не ошибку.

1. Форма 10-Q отчитывается за квартал и за период с начала года с одной и той же датой окончания. Сравнение чистой прибыли по разным отчётностям незаметно смешивает трёхмесячный показатель с девятимесячным. Каждая запись содержит period_type, и вы можете фильтровать по нему.

2. Один и тот же факт повторяется в разных отчётностях с разными значениями. Годовой отчёт 10-K за этот год пересчитывает показатели прошлого года. Дедупликация до одной записи на период, приоритет у самой свежей отчётности — так же, как сам SEC обрабатывает пересмотры.

3. Компании со временем меняют теги XBRL. Microsoft подавала Revenues до 2010 года, а после — другой тег. Если взять первый тег, вернувший данные, получится устаревшая неполная история; здесь же выполняется объединение по всем тегам.

Установка

uvx --from git+https://github.com/groundtruthtools/us-gov-data-mcp us-gov-data-mcp

Claude Desktop — добавьте в claude_desktop_config.json:

{
  "mcpServers": {
    "us-gov-data": {
      "command": "uvx",
      "args": [
        "--from",
        "git+https://github.com/groundtruthtools/us-gov-data-mcp",
        "us-gov-data-mcp"
      ],
      "env": { "SEC_USER_AGENT": "Your Name your@email.com" }
    }
  }
}

Работает с любым MCP-клиентом: Claude Desktop, Claude Code, Cursor, VS Code.

SEC_USER_AGENT задать стоит. Политика добросовестного доступа SEC требует User-Agent с контактным адресом, и запросы без него получают 403. Значение по умолчанию включено, чтобы инструменты работали из коробки, но идентифицировать себя — это вежливо и не даёт оказаться в общей группе.

Один нюанс, усвоенный на горьком опыте: не вставляйте URL в эту строку. SEC возвращает 403 на любой User-Agent, содержащий URL. Ваше Имя your@email.com работает; добавление github.com/... — нет.

На PyPI пока нет, поэтому устанавливайте из репозитория. Когда появится, это станет обычным uvx us-gov-data-mcp.

Честные ограничения

• Контракты: заключённые, а не открытые извещения. За опубликованными торгами — на SAM.gov.

• Контракты: только федеральные, нет данных до 2008 финансового года.

• Поиск повторных конкурсов охватывает контракты с активностью за последний год, потому что USAspending ограничивает глубину прокрутки результатов. Давно неактивный контракт может не появиться, а слишком широкий поиск скажет об этом, а не вернёт уверенно пустой список.

• SEC: покрытие XBRL начинается примерно с 2009 года и охватывает только те концепты, которые компании действительно тегировали. Мелкие эмитенты тегируют меньше.

• Сервер сообщает, а не вычисляет. Никаких коэффициентов, темпов роста или производных показателей — это была бы наша арифметика, а не отчётность, и вы не смогли бы проверить её по источнику.

• Не инвестиционная рекомендация. Это инструмент переформатирования данных.

Также на Apify

Та же логика работает как хостинговые инструменты, без установки:

• US Federal Contract Awards & Recompete Finder

• SEC EDGAR Financial Data & Company Screener

Источники данных и лицензия

Контракты: USAspending.gov, Министерство финансов США, опубликовано в соответствии с DATA Act. Финансовые данные: SEC EDGAR, Комиссия по ценным бумагам и биржам США. Оба источника — общественное достояние. Код: MIT.