contractor-license-mcp-server

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

Отправьте {state, license_number, trade} — и получите данные о действительности лицензии, имени владельца, дате истечения срока, статусе и любых дисциплинарных взысканиях в базе данных. Результаты извлекаются в реальном времени с официальных порталов штатов (никаких устаревших ночных выгрузок) и кэшируются на 24 часа, если они активны.

Почему этот сервер

• 45 штатов охвачены через официальные порталы лицензионных комиссий штатов, а не через сторонние агрегаторы данных

• Проверка в реальном времени — каждый запрос обращается к авторитетному порталу, поэтому информация о сроках действия и дисциплинарных взысканиях всегда актуальна

• Пакетная проверка — до 25 лицензий за один вызов, выполняемых параллельно

• История дисциплинарных взысканий — возвращается, если портал предоставляет такие данные

• Работает на базе TradesAPI, размещенного HTTP API, к которому вы также можете обращаться напрямую

Быстрый старт

Claude Desktop

Добавьте это в конфигурацию Claude Desktop:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

• Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "tradesapi": {
      "command": "npx",
      "args": ["-y", "contractor-license-mcp-server"],
      "env": {
        "CLV_API_URL": "https://www.tradesapi.com",
        "CLV_API_KEY": "your-api-key-here"
      }
    }
  }
}

После сохранения перезапустите Claude Desktop.

Получение API-ключа

1. Перейдите на www.tradesapi.com и нажмите Sign up free

2. Введите свой email — вы получите магическую ссылку

3. Перейдите по ссылке, чтобы попасть на панель управления, где вас будет ждать ваш API-ключ

Новые аккаунты получают 50 бесплатных кредитов на проверку, кредитная карта не требуется. Вы можете приобрести дополнительные пакеты кредитов на панели управления, когда они вам понадобятся.

Прямая установка

npm install -g contractor-license-mcp-server

Инструменты

clv_verify_license

Проверка лицензии одного подрядчика через портал лицензионной комиссии штата.

Пример результата:

## License Verification: VALID

| Field      | Value                    |
|------------|--------------------------|
| Name       | ANDERSON, ORIN RAE       |
| License #  | TACLA00000103C           |
| State      | TX                       |
| Trade      | hvac                     |
| Status     | Active                   |
| Expiration | 05/12/2026               |

clv_batch_verify

Проверка до 25 лицензий за один вызов. Каждая проверка выполняется независимо — частичные сбои не блокируют весь пакет.

clv_list_supported_states

Список всех поддерживаемых штатов, включая URL-адреса порталов и доступные виды деятельности. Используйте это, чтобы узнать, какие штаты и виды деятельности можно запрашивать.

Поддерживаемые штаты

Охват постоянно расширяется. Запустите clv_list_supported_states из вашего агента для получения актуального списка или посмотрите текущую таблицу штатов на www.tradesapi.com.

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

Кредиты

Каждая проверка лицензии потребляет 1 кредит, независимо от того, является ли результат свежим или кэшированным. Новые аккаунты получают 50 бесплатных кредитов. Дополнительные пакеты кредитов можно приобрести на панели управления по адресу www.tradesapi.com.

Разработка

git clone https://github.com/jackunderwood/Contractor-License-Verification.git
cd Contractor-License-Verification/mcp-server
npm install
npm run build
npm test

Лицензия

MIT