USA Spending MCP

Stateless streamable HTTP MCP сервер для взаимодействия с USASPENDING.gov — официальным источником данных о государственных расходах. Позволяет отслеживать государственные расходы во времени, искать по ведомствам и изучать расходы на сообщества.

Установка

Локально (uv)

uv run src/server.py

PyPi

uvx --from usaspending-mcp-server@latest usaspending-mcp-server

Docker

docker build -t usaspending-mcp-server .
docker run -p 8000:8000 usaspending-mcp-server

Конфигурация

Claude Desktop

{
  "mcpServers": {
    "usaspending": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "http://localhost:8000/mcp"
      ]
    }
  }
}

Доступные инструменты

Инструмент	Описание
`federal_accounts`	Возвращает список федеральных счетов, их номера, названия, управляющие ведомства и бюджетные ресурсы
`list_budget_functions`	Получает список всех бюджетных функций, отсортированный по названию
`major_object_class`	Используется для понимания различных способов расходования средств конкретным ведомством
`recipient`	Визуализирует государственные расходы, относящиеся к конкретному получателю, возвращая получателей, их...
`spending`	Детализация конкретных подмножеств данных по уровню детализации, представляющая все государственные расходы...
`spending_by_award`	Позволяет использовать комплексную фильтрацию для конкретных подмножеств данных о расходах с фильтрами и полями
`spending_over_time`	Возвращает агрегированные суммы вознаграждений, сгруппированные по временным периодам в порядке возрастания
`subawards`	Возвращает отфильтрованный набор субконтрактов
`total_budgetary_resources`	Предоставляет информацию о федеральных бюджетных ресурсах правительства
`toptier_agencies`	Используется для понимания различных способов расходования средств конкретным ведомством

Возможности

Отслеживание государственных расходов во времени
Поиск государственных расходов по ведомствам
Изучение государственных расходов на сообщества
Комплексная фильтрация для конкретных подмножеств данных о расходах
Визуализация государственных расходов по конкретным получателям
Доступ к информации о федеральных бюджетных ресурсах
Stateless streamable HTTP MCP сервер

Переменные окружения

Опциональные

MCP_SERVER_HOST - Настройка хоста, на котором запускается MCP сервер
MCP_SERVER_PORT - Настройка порта, на котором запускается MCP сервер

Примеры использования

How many federal accounts are there?

What are the budget functions?

What are the various ways the Department of Education spends money?

What are some companies that received funding from the NSA?

What was some spending related to International Affairs?

Ресурсы

GitHub Repository

Примечания

Все инструменты организованы в директории tools с markdown файлами для документации. API контракты ссылаются на коммит dv551d0 из usaspending-api. MCP Inspector можно использовать для тестирования схем ввода/вывода. Доступен пример MCP клиента для тестирования с OpenAI.

Installation

Description