API ВЕГА

@cliwant/mcp-sam-gov

Самый полный федеральный MCP-сервер с приоритетом работы без ключей. SAM.gov · USAspending · SEC EDGAR · OFAC · FDIC · Federal Register · Regulations.gov · eCFR · FAR/DFARS · BLS · Treasury · NIH · NSF · ClinicalTrials · CMS · NVD/CISA · USITC · Census · FRED · BEA · DOL · FEMA · openFDA · NHTSA · CPSC · EPA Envirofacts · CourtListener · IRS-990(ProPublica) и другие: 54 источника данных, 153 инструмента. Приоритет — работа без ключей: бесплатный ключ нужен только для 4 источников — Census business-patterns · FRED · BEA · DOL data endpoints. Остальные 50 источников не требуют ключа. Для 148 из 153 инструментов не нужны API-ключ, регистрация или создание аккаунта. Поддерживаются Claude Desktop, Claude Code, Codex CLI, Cursor, Continue, Gemini CLI и все MCP-хосты. Независимый проект — не связан, не одобрен и не спонсируется SAM.gov, General Services Administration (GSA) или любым другим государственным учреждением США.

README на английском · README на корейском

Этот документ — копия README на английском. Актуальную и подробную информацию (настройки для разных хостов и полный каталог инструментов в оригинале) см. в английской версии.

Что Claude и другие AI-агенты могут делать

ОбластьПример запросаИсточники
🔍 Возможности и solicitation«Возможности SAM.gov по NAICS 541512 со сроком подачи в этом месяце — включая SOW, контакты и вложения»SAM.gov, Grants.gov
💰 Расходы, контракты и конкуренты«Контракты Booz Allen с VA за прошлый финансовый год, 10 ведущих категорий PSC для DoD»USAspending, FPDS, GAO
🕵️ Проверка партнёров и компаний«Проверьте эту компанию: санкции OFAC, исключение SAM, замечания аудита единого типа, финансовая устойчивость банка, соблюдение требований EPA и выбросы опасных веществ»OFAC, SAM, FAC, FDIC, EPA ECHO, EPA Envirofacts
🛒 Безопасность продукции и отзывы«Были ли отзывы или меры принудительного воздействия FDA/NHTSA/CPSC в отношении продукции этого поставщика?»openFDA, NHTSA, CPSC
⚖️ Судебные разбирательства и суды«Протесты по тендерам в Федеральном суде по претензиям, связанные с этим подрядчиком, и решения Федерального апелляционного суда»CourtListener (Free Law Project)
🏢 Некоммерческие поставщики«Проверьте финансовую отчётность IRS-990 этой некоммерческой организации перед заключением субподряда»IRS 990 (через ProPublica)
🏥 Медицинские организации и учреждения«Использование Medicare и выплаты этому поставщику медицинских услуг, рейтинг качества больницы и наличие в списке исключённых организаций»CMS (data.cms.gov)
📈 Финансовая отчётность (SEC)«Динамика выручки этой публичной компании и последняя форма 10-K»SEC EDGAR
⚖️ Регулирование и законодательство«Какие правила кибербезопасности VA действуют в этом квартале? Есть ли активные docket в Regulations.gov?»Federal Register, Regulations.gov, eCFR, FAR/DFARS, Congress.gov, GovInfo
💲 Цены, труд и финансы«Диапазоны ставок труда в GSA CALC, определение заработной платы SCA для этого округа, корректировка по CPI, максимальные суточные для командировок, ВВП по отраслям в регионе, история трудовых нарушений и заработной платы по данным DOL»GSA CALC, SAM WD, BLS, US Census CBP, FRED, BEA, US Treasury, GSA per-diem, US DOL
🏛 Лоббизм и влияние«Кто лоббирует VA по вопросам кибербезопасности и сколько тратит?»US Senate LDA
🏥 Финансирование здравоохранения и исследований«Гранты NIH/NSF по этой теме, открытые клинические испытания, выплаты отрасли этому врачу»NIH RePORTER, NSF, ClinicalTrials, CMS, NPPES
🛡 Соблюдение требований кибербезопасности«Включена ли эта CVE в обязательный список исправлений CISA KEV?»NVD, CISA KEV
🌐 Торговля, география и чрезвычайные ситуации«Тариф HTS для этого товара, Census tract для этого адреса, декларации FEMA для этого штата»USITC HTS, Census, FEMA, Socrata, CKAN
🏙 Тендеры штатов и местных органов власти (SLED)«Какие тендеры сейчас открыты на портале закупок этого города/округа? Посмотрите его checkbook, заключённые контракты и выплаты поставщикам, а также реестр тендеров и победителей DOT штата»OpenGov Procurement (525+ органов власти), Bonfire, ArcGIS (feature + Hub), Socrata (54 хоста), 1 публичное представление Tableau Server Guest (Монтана), 1 Socrata Open Expenditures checkbook (Южная Дакота)
🎓 Гранты и наборы данных«Гранты на кибербезопасность за последние 30 дней, поиск федеральных открытых наборов данных»Grants.gov, data.gov

54 источника данных, всего 153 инструмента — приоритет работы без ключей: бесплатный ключ нужен только для 4 источников — Census business-patterns · FRED · BEA · DOL data endpoints. Остальные 50 источников не требуют ключа. (В начальной версии с 52 инструментами измеренное время отклика составляло примерно p50 ~0.25s / p95 ~0.8s. Это ориентировочные значения, которые зависят от источника и нагрузки на upstream-сервисы, а не гарантированные показатели.)

Как установить? Выберите подходящий вариант

🟢 Вариант 1 — установка в Claude Desktop в один клик (без терминала)

Рекомендуется пользователям без опыта разработки. Скачайте один файл и запустите его двойным щелчком.

  • Скачайте mcp-sam-gov.mcpb со страницы последнего релиза.

  • Дважды щёлкните файл. В Claude Desktop появится диалоговое окно "Install Extension".

  • Нажмите Install.

  • Готово. Откройте новый диалог и спросите: "Find active SAM.gov opportunities under NAICS 541512".

PowerShell, npm и другие инструменты не нужны.

Требуется Claude Desktop ≥ 1.0 (в комплект входит собственная среда выполнения Node.js).

🟡 Вариант 2 — одна команда для Claude Code

Если вы уже используете Claude Code (CLI):

/plugin install cliwant/mcp-sam-gov

Команда также регистрирует MCP-сервер и руководство по рабочим процессам SKILL.md, которое объясняет Claude, когда и как вызывать 153 инструмента.

🔵 Вариант 3 — ручная установка для Codex / Cursor / Continue / Gemini и других

gh repo clone cliwant/mcp-sam-gov
cd mcp-sam-gov
npm install --omit=dev
npm install -g .

После установки mcp-sam-gov будет доступен в PATH. Добавьте его в конфигурацию хоста (при глобальной установке):

{
  "mcpServers": {
    "sam-gov": { "command": "mcp-sam-gov" }
  }
}

Без глобальной установки (npx) — можно обойтись без клонирования репозитория и npm install -g; понадобится только Node.js. При первом запуске npx загрузит пакет из npm и сохранит его в кэше.

{ "mcpServers": { "sam-gov": { "command": "npx", "args": ["-y", "@cliwant/mcp-sam-gov"] } } }

Чтобы зарегистрировать сервер через CLI Claude Code:

claude mcp add sam-gov -- npx -y @cliwant/mcp-sam-gov

Если в Windows хост не может запустить сервер и выдаёт ошибку spawn npx ENOENT, запустите npx через cmd /c: "command": "cmd", "args": ["/c", "npx", "-y", "@cliwant/mcp-sam-gov"].

Обратите внимание на имя пакета: имя npm-пакета со scope — @cliwant/mcp-sam-gov. mcp-sam-gov — только имя исполняемого файла, доступного в PATH после глобальной установки; пакета mcp-sam-gov без scope в npm нет. Поэтому команда npx -y mcp-sam-gov завершится ошибкой 404. Используйте npx -y @cliwant/mcp-sam-gov.

В VS Code в файле .vscode/mcp.json используется ключ "servers". Установить сервер в один клик также можно через элементы Install in VS Code / Add to Kiro в верхней части английского README.

Расположение конфигурационных файлов для разных хостов и примеры настройки npx для каждого хоста приведены в разделе Конфигурации хостов английского README.

⚪ Вариант 4 — запуск по прямому пути (без глобальной установки)

gh repo clone cliwant/mcp-sam-gov
cd mcp-sam-gov
npm install --omit=dev

Укажите в конфигурации хоста абсолютный путь:

{
  "mcpServers": {
    "sam-gov": {
      "command": "node",
      "args": ["C:\\Users\\you\\mcp-sam-gov\\dist\\server.js"]
    }
  }
}

О чём можно спрашивать?

Задавайте вопросы обычным языком: AI автоматически вызовет подходящую последовательность инструментов.

Поиск возможностей

  • «Возможности в Мэриленде по NAICS 541512 со сроком подачи в течение 30 дней»

  • «Какой стандартный код NAICS соответствует 'computer systems design'?»

Анализ RFP

  • «Покажите SOW, контактные данные и все вложения для noticeId 5ef3db5daeb54099a96d487783a38bd0»

  • «Покажите полный текст RFP для этой возможности»

Анализ конкурентов

  • «Топ-5 контрактов с VA по NAICS 541519 за прошлый год»

  • «Отдельные позиции контракта Booz Allen с DISA»

  • «Кто является субподрядчиком по контракту Leidos с VA?»

  • «Каково официальное название 'CMS' в USAspending?»

Тенденции и сводные данные

  • «Динамика расходов VA по 541512 за 5 лет»

  • «10 ведущих штатов по расходам на 541512»

  • «Ведущие категории PSC по расходам DoD»

  • «Программы грантов, связанные с кибербезопасностью, в порядке общей суммы финансирования»

Информация об агентстве (справка для capture)

  • «Справка для capture по VA: миссия, разбивка бюджета FY26, ведущие подведомственные организации»

  • «Объём транзакций VA за FY25»

Поиск контрактов на повторный конкурс

  • «Контракты VA по 541512 стоимостью более $1M, срок действия которых истекает в течение 12 месяцев»

  • «Срок выполнения работ по award CONT_AWD_...»

Регулирование

  • «Разделы FAR, связанные с предпочтительным размещением заказов SDVOSB»

  • «Новые правила VA по кибербезопасности за этот квартал»

  • «Библиографическая ссылка на документ Federal Register 2026-08333»

Гранты

  • «Гранты на кибербезопасность за последние 30 дней»

  • «Подробности по grant id 361238»

Дополнительно — повышение лимитов запросов и доступ к архиву

По умолчанию сервер работает без ключей. Чтобы увеличить лимиты запросов к SAM.gov и получить доступ к архивным данным старше 12 месяцев, добавьте ключ SAM.gov в переменные окружения хоста:

{
  "mcpServers": {
    "sam-gov": {
      "command": "mcp-sam-gov",
      "env": { "SAM_GOV_API_KEY": "your-key-here" }
    }
  }
}

Бесплатный ключ можно получить на sam.gov/SAM/pages/public/searchKeyData.jsf. AI не нужно знать о ключе — переключение выполняется автоматически.

DATA_GOV_API_KEY — семейство api.data.gov / api.gsa.gov

Некоторые источники (Congress.gov, GovInfo, Regulations.gov, FAC, суточные командировочные выплаты GSA (per-diem), каталог data.gov v4) используют общий шлюз api.data.gov. По умолчанию они работают без ключа, используя общедоступный DEMO_KEY с низким общим лимитом запросов в час. Укажите DATA_GOV_API_KEY, чтобы значительно увеличить лимит. Бесплатный ключ можно сразу получить на api.data.gov/signup, ожидать не нужно. Один ключ подходит для всех источников api.data.gov / api.gsa.gov. Для источников BLS дневной лимит запросов также можно увеличить с помощью бесплатного BLS_API_KEY.

Ключ обязателен только для 4 источников — Census (census_business_patterns), FRED (2 инструмента FRED), BEA (bea_regional_data), DOL data endpoints (dol_get_dataset; каталог dol_list_datasets работает без ключа). Все ключи бесплатны. Полный перечень ключей (обязательные и необязательные, URL для регистрации) приведён в разделе о ключах английского README.

Выбор набора инструментов (сокращение контекста)

По умолчанию загружаются все 153 инструмента, что занимает около 80k токенов на сессию. Чтобы сократить объём контекста, укажите в переменной окружения MCP_SAM_GOV_TOOLSETS имена нужных наборов инструментов через запятую. Пустое значение или all загружает все инструменты. Доступны следующие наборы: core (58 инструментов: SAM/Grants/USAspending/FAR/eCFR/Federal Register/SBA и другие), sled (13 инструментов: закупки штатов и местных органов власти), vetting (17 инструментов: OFAC/FDIC/FAC/EPA ECHO и другие), disclosure (8 инструментов: SEC EDGAR), regulatory (9 инструментов: Regulations.gov/Congress/GovInfo), pricing (15 инструментов: GSA/BLS/Treasury/FRED/DOL и другие), health (17 инструментов: CMS/NIH/NSF/openFDA и другие), safety (3 инструмента: NHTSA/CPSC), geo (9 инструментов: Census geocode/FEMA/NWS и другие), cyber (3 инструмента: NVD/CISA KEV/NIST 800-53). При вызове незагруженного инструмента возвращается ошибка tool_not_loaded с указанием набора, в котором этот инструмент можно включить.

Как поддерживать актуальную версию

npm не уведомляет пользователей об обновлениях установленных пакетов, поэтому сервер сообщает о них с минимальным вмешательством. При запуске он отправляет один анонимный запрос к публичному реестру npm, чтобы проверить наличие новой версии, и выводит одну строку в stderr только если доступна более новая версия (например, a newer version is available: 1.7.0 → 1.8.0). Данные об использовании не отправляются (это проверка версии, а не телеметрия); протоколный stdout не затрагивается. Проверка выполняется в фоновом режиме, а если установлена последняя версия, никаких сообщений не появляется.

  • Обновление: npm i -g @cliwant/mcp-sam-gov@latest — либо просто перезапустите сервер, если он настроен через npx @cliwant/mcp-sam-gov@latest.

  • Отключение: MCP_SAM_GOV_NO_UPDATE_CHECK=1 (или NO_UPDATE_NOTIFIER=1).

  • Список изменений: релизы и CHANGELOG.

Сообщение об ошибке или запрос функции — в один шаг

Этот сервер улучшается благодаря реальному использованию. Поскольку инструменты вызывают AI-агенты, а не люди, обратная связь тоже отправляется через агента:

  • В конвертах ошибок schema_drift (изменение структуры федерального API) и upstream_unavailable (сбой) есть поле report — готовая ссылка для создания GitHub Issue.

  • Также можно попросить агента «сообщить об ошибке», «проверить странный результат» или «добавить функцию». В ответ инструмент feedback вернёт готовую ссылку.

Автоматическая отправка не выполняется. У сервера нет ни токена, ни аккаунта: он только создаёт ссылку. Открыть её и отправить сообщение должны вы сами. В готовую ссылку включены только название инструмента, тип ошибки и версия сервера; значения запросов в неё не добавляются. Репозиторий общедоступный, поэтому перед отправкой удалите конфиденциальные сведения. Открыть напрямую: Создать issue.

Каталог инструментов (153)

Инструменты сгруппированы по сценариям. Приоритет отдан работе без ключей: большинство инструментов не требует ключа, но для конечных точек Census business-patterns, FRED, BEA и DOL нужны бесплатные ключи. Полный перечень инструментов с входными schema и исходными оговорками о достоверности приведён в разделе каталога английского README.

  • Контракты и запросы предложений — SAM.gov + Grants.gov (10): sam_search_opportunities sam_search_shaping sam_get_opportunity sam_fetch_description sam_fetch_attachment_text sam_attachment_url sam_lookup_organization sam_lookup_notice_fields grants_search grants_get_opportunity

  • Расходы, контракты и конкуренты — USAspending + FPDS + GAO (31): usas_search_awards usas_search_individual_awards usas_get_award_detail usas_search_awards_by_recipient usas_search_subawards usas_search_recompetes usas_search_expiring_contracts (устарел) usas_analyze_incumbent usas_search_teaming_partners usas_spending_over_time usas_search_agency_spending usas_search_subagency_spending usas_search_psc_spending usas_search_cfda_spending usas_search_state_spending usas_search_federal_account_spending usas_search_recipients usas_get_recipient_profile usas_get_agency_profile usas_get_agency_awards_summary usas_get_agency_budget_function usas_list_toptier_agencies usas_lookup_agency usas_autocomplete_naics usas_autocomplete_recipient usas_naics_hierarchy usas_glossary usas_list_disaster_codes (список кодов Disaster Emergency Fund (DEFC) — метки чрезвычайных ассигнований, включая COVID-19 и IIJA/инфраструктуру) usas_disaster_spending (разбивка расходов по указанным фондам DEFC для ликвидации последствий бедствий и чрезвычайных ситуаций — показывает, какие штаты, округа и избирательные округа получили средства помощи по COVID/IIJA) fpds_search_awards gao_protest_lookup

  • Проверка партнёров и компаний — OFAC · SAM · FAC · FDIC · EPA (15): ofac_screen_entity sam_check_exclusions sam_integrity_lookup fac_search_audits fac_get_findings fdic_search_institutions fdic_institution_financials fdic_risk_ratios fdic_institution_history fdic_branch_deposits fdic_bank_failures fdic_industry_summary echo_search_facilities echo_facility_report epa_tri_facilities (объекты EPA Envirofacts TRI, выбрасывающие токсичные вещества, — проверка экологических и ESG-показателей)

  • Безопасность продукции и отзывы — openFDA · NHTSA · CPSC (6): openfda_enforcement (отзывы продукции и меры контроля FDA в отношении лекарств, медицинских устройств и продуктов питания) openfda_device_clearances (разрешения FDA на медицинские устройства 510(k)) openfda_drug_approvals (заявки на одобрение лекарств из openFDA Drugs@FDA — спонсоры, одобренные препараты, история подачи и одобрения) nhtsa_recalls (отзывы транспортных средств NHTSA) nhtsa_complaints (жалобы в NHTSA по безопасности транспортных средств) cpsc_recalls (отзывы потребительских товаров CPSC)

  • Судебные дела и суды — CourtListener (2): courtlistener_search_opinions (решения федеральных судов США, в том числе по контрактным спорам и протестам против тендеров в Суде федеральных исков и Федеральном апелляционном суде; через CourtListener/Free Law Project, что указано явно)

  • Некоммерческие организации — IRS 990 через ProPublica (2): nonprofit_search (поиск некоммерческих организаций в IRS-990 по названию, штату или NTEE) nonprofit_financials (финансовые данные некоммерческой организации из IRS-990 по EIN) — через ProPublica Nonprofit Explorer, что указано явно

  • Финансовая отчётность — SEC EDGAR (8): edgar_lookup_cik edgar_company_filings edgar_company_facts edgar_company_concept edgar_xbrl_frames edgar_full_text_search edgar_filing_index edgar_daily_filing_index

  • Регулирование и законодательство — Federal Register · Regulations.gov · eCFR · FAR · Congress · GovInfo (19): fed_register_search_documents fed_register_get_document fed_register_public_inspection fed_register_list_agencies regulations_search_dockets regulations_search_documents regulations_search_comments regulations_get_docket ecfr_search ecfr_get_section (получение полного текста одного раздела CFR по ссылке на него — доступны все разделы; для FAR/DFARS рекомендуется far_clause_lookup) ecfr_list_titles far_clause_lookup far_search far_compliance_matrix congress_search_bills congress_get_bill govinfo_search_packages govinfo_get_package govinfo_list_collections

  • Цены, трудовые ресурсы и бюджет — GSA CALC · SAM WD · BLS · Census CBP · FRED · BEA · Treasury · GSA per-diem (15): gsa_benchmark_labor_rates sam_search_wage_determinations sam_get_wage_rates bls_timeseries bls_oews_wages bls_qcew treasury_debt_to_penny treasury_avg_interest_rates treasury_monthly_statement treasury_query_dataset bea_regional_data (нужен бесплатный BEA_API_KEY) census_business_patterns (нужен бесплатный CENSUS_API_KEY) fred_search_series (нужен бесплатный FRED_API_KEY) fred_series_observations (нужен бесплатный FRED_API_KEY) gsa_perdiem_rates (работает без ключа с DEMO_KEY)

  • Медицина и исследовательское финансирование — NIH · NSF · ClinicalTrials · CMS · NPPES (9): nih_reporter_search_projects nsf_search_awards nsf_get_award clinicaltrials_search_studies clinicaltrials_get_study clinicaltrials_facet_counts cms_search_datasets cms_query_dataset nppes_lookup_provider

  • Медицинские учреждения и специалисты — CMS (5): cms_medicare_provider_services (использование услуг Medicare и выплаты поставщикам медицинских услуг — оценка размера медицинского рынка) cms_hospital_compare (оценка качества больниц CMS) cms_facility_directory (справочник учреждений по уходу, медицинской помощи на дому, хосписов и диализных центров) cms_dmepos_suppliers (справочник поставщиков медицинского оборудования DMEPOS и расходы Medicare) cms_revoked_providers (список поставщиков, у которых отозвано участие в Medicare или которые исключены из программы, — проверка соответствия требованиям)

  • Кибербезопасность и соблюдение требований — NVD + CISA KEV + NIST 800-53 (3): cve_lookup cisa_kev_lookup nist_800_53_controls (поиск мер безопасности и конфиденциальности из NIST SP 800-53 Rev 5 — тексты требований FedRAMP/CMMC/RMF по controlId, семейству или ключевому слову)

  • Торговля, тарифы и логистика — USITC · CBP (2): hts_lookup cbp_border_wait_times (текущее время ожидания коммерческого транспорта на сухопутных пограничных переходах CBP с Канадой и Мексикой — данные для грузоперевозок и логистики)

  • География, стихийные бедствия и открытые данные штатов и городов — Census · FEMA · NWS · Socrata · CKAN (10): census_geocode_address census_geographies_by_coordinates fema_disaster_declarations fema_search_public_assistance fema_search_hazard_mitigation (проекты FEMA по снижению риска стихийных бедствий — программы субсидий HMGP/FMA/PDM/BRIC; не путать с восстановлением после бедствий по программе Public Assistance) nws_active_alerts (текущие действующие метеопредупреждения NWS — предупреждения, уведомления и рекомендации; подготовка к бедствиям и климатическим явлениям, можно использовать вместе с инструментами FEMA) socrata_discover_datasets socrata_query ckan_discover_datasets ckan_query

  • Закупки штатов и местных органов власти (SLED) — OpenGov · Bonfire · ArcGIS · Tableau · Open Checkbook (8): opengov_list_governments (справочник из 525+ органов власти штатов и местных органов власти США на OpenGov Procurement; фильтрация по штату или названию) opengov_search_solicitations (опубликованные запросы предложений для выбранного органа власти — название, статус [open = приём заявок], срок подачи и ссылка на портал; анонимная конечная точка, работающая без ключа) bonfire_list_organizations (частичный справочник из 187 проверенных организаций Bonfire (Euna), отобранных и проверенных в реальном времени) bonfire_search_opportunities (получение текущих открытых запросов предложений для выбранной организации через RSS без ключа — referenceNumber, название, closeDate и ссылка; RSS содержит все открытые запросы, поэтому общее количество точное) arcgis_hub_discover_datasets (поиск наборов данных ArcGIS Hub по ключевым словам — GIS, инфраструктура, разрешения и закупки SLED, недоступные через Socrata/CKAN; вспомогательный поиск с указанием издателя, которого нужно проверить перед использованием) arcgis_feature_query (запрос строк из отобранного списка разрешённых 29 слоёв ArcGIS REST государственных органов США: открытые запросы предложений DC OCP PASS, чеки и контракты местных органов власти, планы капиталовложений округов (Hennepin County MN и Charlotte-Mecklenburg NC — планы капитальных улучшений, а не регистрация тендерных заявок), реестры тендеров и присуждённых контрактов DOT штатов (TX / AK / IA / OK), а также 4 слоя грантов федерального гибкого финансирования DOT Северной Дакоты — получатели грантов являются местными государственными учреждениями, например округами, тауншипами и городами, а не поставщиками; поскольку общедоступные реестр расходов штата и портал закупок ND недоступны без ключа, вместо них используются данные о грантах DOT) tableau_view_csv (получение полного CSV-экспорта представлений Tableau Server Guest государственных органов США без ключа с постраничной выдачей; сейчас доступно только одно представление: контракты DOA штата Монтана с присуждёнными контрактами (~4 554 записи); актуальность зависит от издателя, поэтому данные могут обновляться с задержкой) open_checkbook_search (поиск отдельных платежей поставщикам на порталах Socrata Open Expenditures без ключа; точные фильтры по финансовому году, поставщику, ведомству и статье расходов; сейчас доступны 2 портала: штат Южная Дакота (~740 980 записей за последние ~3 финансовых года) и штат Аляска (41 751 запись, только FY2026 — отсутствие записей за другие годы означает, что данные не опубликованы, а не отсутствие расходов); актуальность зависит от издателя, поэтому данные могут обновляться с задержкой; чтобы найти последние записи, проверяйте payment_date в порядке убывания)

  • Карты открытых данных штатов и местных органов власти: справочник проверенных наборов данных по штатам, их идентификаторов, числа строк и оговорок доступен в ресурсе MCP samgov://data-map/state-local (его можно просмотреть с любого клиента через resources/read) и в skills/sam-gov/SKILL.md (например, закупки TX DIR — 10,75 млн+ записей, текущие тендеры TxDOT — 412 записей, MA CTHRU — ~49 млн записей, VA eVA — 1,69 млн записей). Это зеркала открытых данных, а не официальные порталы тендеров штатов (тендеры TxDOT стали первым потоком тендеров штата в реальном времени). Во FL и GA порталов открытых данных нет; в PA портал существует, но данные о закупках отсутствуют — это подтверждённое состояние.

  • Поиск в реестрах наборов данных — data.gov · get.gov (2): datagov_search_datasets search_gov_domains (официальный реестр доменов .gov CISA get.gov — определение ведомства, которому принадлежит домен; перечень федеральных ведомств и сопоставление с SLED)

  • Малый бизнес — SBA (1): sba_size_standard

  • Соблюдение трудового законодательства — US DOL (2): dol_list_datasets (просмотр каталога наборов данных о проверках и соблюдении требований DOL, включая WHD, OFCCP и другие; работает без ключа) dol_get_dataset (получение записей о проверках DOL — WHD, заработная плата и трудовые отношения / OFCCP; нужен бесплатный DOL_API_KEY)

  • Лоббирование и влияние — US Senate LDA (1): lda_search_filings (отчётность по лоббистской деятельности в Сенате: кто, на какие органы, по каким вопросам и сколько тратит; работает без ключа)

  • Утилиты сервера — поиск ключей и обратная связь (2): api_key_status (перечень ключей, необходимых каждому источнику, отметки required/optional, URL регистрации и наличие текущих настроек; значения ключей не отображаются) feedback (создание готовой ссылки GitHub Issue для сообщения об ошибке или запроса функции; открыть ссылку и отправить сообщение должен сам пользователь, инструмент ничего не отправляет)

Надёжность и офлайн-снимки

У сервера есть один принцип: честный отказ лучше правдоподобной выдумки. Всё описанное ниже касается только доступности общедоступных данных и не позволяет обходить какие-либо средства контроля доступа.

  • Приоритет источникам без ключей; недоступные источники вызывают ошибку. 50 из 54 источников (148 из 153 инструментов) работают без API-ключа. Бесплатный ключ требуется только для Census business-patterns, FRED, BEA и DOL data endpoints. Если источник ограничивает частоту запросов, блокирует доступ или недоступен, инструмент возвращает типизированную ошибку (rate_limited / upstream_unavailable / schema_drift …), а не выдумывает строки и не сообщает о сбое сервиса как о «нулевом количестве результатов» или «ничего не найдено». Настоящие пустые результаты всегда можно отличить от сбоев.

  • Офлайн-снимки (включены по умолчанию). Медленно меняющиеся справочные данные (список организаций высшего уровня, дерево NAICS верхнего уровня, глоссарий USAspending, критерии размеров SBA, последние данные Treasury «Debt to the Penny») при временной недоступности федеральных источников из-за ограничений egress по умолчанию берутся из общедоступных снимков с еженедельным обновлением, размещённых на raw.githubusercontent.com/cliwant/mcp-sam-gov/snapshots. Снимки загружаются только при серьёзном сбое live-источника (сбой или блокировка по IP-репутации), но не при обычной работе. Данные общедоступны, телеметрия не собирается. Если используются снимки, сервер никогда не выдаёт их за live-данные: ответ содержит _meta.dataPath: "snapshot" и временную метку asOf, а complete принудительно отключается. Ограничения частоты запросов (429) всегда соблюдаются — перехода на зеркало в обход них нет.

  • Отключение (только live-источники): задайте SAMGOV_SNAPSHOT_BASE_URL=off, чтобы не использовать снимки. Клиент будет работать только с live-источниками и выдавать побайтно идентичные результаты.

  • Использование собственного зеркала: задайте для SAMGOV_SNAPSHOT_BASE_URL собственный base URL — он будет использоваться вместо общедоступного адреса по умолчанию.

  • Сборка снимков: выполните node scripts/build-snapshots.mjs из чистой среды с доступом к egress без блокировок (ноутбук, домашняя сеть или чистая CI). Скрипт самостоятельно проверит доступность каждого источника и выведет таблицу доступности вместе с manifest.json. При частичной доступности обновятся только доступные источники, а для остальных сохранятся последние корректные файлы — даже если они устарели. Снимки не будут пустыми. Ненулевой код завершения возвращается, только если недоступны все источники. Это указывает на полную блокировку egress; запустите сборку повторно из среды с более свободным доступом.

  • Честные ограничения. Этот механизм касается только доступности общедоступных данных. Сборщик получает только общедоступные данные, разрешённые для повторного распространения (public-domain / CC0), а читатель отказывается предоставлять конверты, у которых accessLevel не равен "public". Сервер соблюдает ограничения частоты запросов и не обходит ответы 429. Он не использует прокси, ротацию IP-адресов и обход аутентификации, платного доступа или CAPTCHA, а также отклоняет перенаправления на сторонние хосты. Если доступ заблокирован, честное решение — выполнить сборку из среды с более свободным доступом, а не обходить блокировку.

Устранение неполадок

СимптомРешение
sam-gov не отображается в меню Claude Desktop 🔨Полностью закройте Claude Desktop (Windows: через системный трей; macOS: Quit) и запустите его снова. Журналы: %APPDATA%\Claude\logs\mcp*.log
command not found: mcp-sam-govУбедитесь, что команда npm install -g . завершилась успешно. Проверьте, что результат npm config get prefix входит в PATH
spawn npx ENOENT (Windows, конфигурация npx)Хост запустил npx без оболочки, поэтому Windows не может найти npx.cmd. Используйте "command": "cmd", "args": ["/c", "npx", "-y", "@cliwant/mcp-sam-gov"]
MODULE_NOT_FOUND ...dist/server.js (Windows)Ошибка npm при установке git-зависимости и работе с symlink. Используйте способ 3 (клонирование и npm install -g .)
EPERM: operation not permittedВыполните rmdir /s /q "%APPDATA%\npm\node_modules\@cliwant" (если устанавливались ранние версии — также @govicon") и повторите попытку
Инструмент возвращает пустой результатВозможно, SAM.gov ограничил частоту запросов. Подождите 1 минуту и повторите попытку или задайте SAM_GOV_API_KEY

Лицензия

MIT — LICENSE.

Отказ от ответственности

Этот сервер — независимый проект с открытым исходным кодом. Он не связан и не аффилирован, не одобрен и не спонсируется какими-либо федеральными, региональными или местными государственными органами, включая General Services Administration (GSA), SAM.gov, USAspending.gov, Office of the Federal Register, National Archives и Grants.gov. Сервер использует только общедоступные государственные источники открытых данных. Данные о федеральных закупках, расходах и нормативных актах являются общественным достоянием.