contractor-license-mcp-server

미국 45개 주에 걸친 실시간 건설업자 면허 검증. Claude Desktop, Cursor 및 모든 MCP 호환 AI 에이전트가 건설업자의 면허, 상태, 만료일 및 징계 이력을 주 면허 위원회 포털에서 직접 검증할 수 있도록 하는 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 키 발급받기

www.tradesapi.com에 접속하여 Sign up free를 클릭하세요.
이메일을 입력하면 매직 링크를 받게 됩니다.
링크를 클릭하여 대시보드로 이동하면 API 키가 준비되어 있습니다.

신규 계정은 50개의 무료 검증 크레딧으로 시작하며, 신용카드는 필요하지 않습니다. 더 많은 크레딧이 필요하면 대시보드에서 추가 크레딧 팩을 구매할 수 있습니다.

직접 설치

npm install -g contractor-license-mcp-server

도구

`clv_verify_license`

단일 건설업자 면허를 주 면허 위원회 포털에서 검증합니다.

매개변수	필수	설명
`state`	예	2글자 주 코드 (`CA`, `TX`, `FL`, ...)
`license_number`	예	검증할 면허 번호
`trade`	아니오	`general`, `electrical`, `plumbing`, `hvac`, `mechanical`, `residential`, 또는 `home_inspection` (기본값: `general`)
`force_refresh`	아니오	24시간 캐시를 무시하고 포털에서 다시 가져오기
`response_format`	아니오	`markdown` (기본값) 또는 `json`

결과 예시:

## 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개의 면허를 검증합니다. 각 검증은 독립적으로 실행되며, 일부 실패가 전체 배치를 차단하지 않습니다.

매개변수	필수	설명
`licenses`	예	`{ state, license_number, trade }` 객체 배열 (1~25개)
`response_format`	아니오	`markdown` (기본값) 또는 `json`

`clv_list_supported_states`

포털 URL 및 사용 가능한 업종을 포함하여 지원되는 모든 주를 나열합니다. 이를 통해 어떤 주와 업종을 조회할 수 있는지 확인할 수 있습니다.

매개변수	필수	설명
`response_format`	아니오	`markdown` (기본값) 또는 `json`

지원되는 주

코드	주	업종
AK	알래스카	general, electrical, mechanical
AL	앨라배마	general, electrical, plumbing, hvac, residential
AR	아칸소	general
AZ	애리조나	general, electrical, plumbing, hvac
CA	캘리포니아	general, electrical, plumbing, hvac
CO	콜로라도	electrical, plumbing
CT	코네티컷	general, electrical, plumbing, hvac
DC	워싱턴 D.C.	general
DE	델라웨어	electrical, plumbing, hvac
FL	플로리다	general, electrical, plumbing, hvac
GA	조지아	general
HI	하와이	general
IA	아이오와	electrical
ID	아이다호	electrical, plumbing, hvac
IL	일리노이	general, electrical, plumbing, hvac
IN	인디애나	plumbing
KY	켄터키	general, electrical, hvac, plumbing
LA	루이지애나	general
MA	매사추세츠	general, mechanical
MD	메릴랜드	general, hvac, electrical, plumbing
ME	메인	electrical, plumbing
MI	미시간	electrical, plumbing, hvac
MN	미네소타	general, electrical, plumbing
MS	미시시피	general
NC	노스캐롤라이나	general
ND	노스다코타	general, electrical
NE	네브래스카	general, electrical
NH	뉴햄프셔	electrical, plumbing
NJ	뉴저지	general, electrical, hvac, plumbing
NM	뉴멕시코	general, electrical, plumbing, hvac
NV	네바다	general, electrical, plumbing, hvac
NY	뉴욕	home_inspection
OH	오하이오	general, electrical, plumbing, hvac
OK	오클라호마	electrical, plumbing, hvac
OR	오리건	general
PA	펜실베이니아	general, electrical, hvac, plumbing
RI	로드아일랜드	general
SC	사우스캐롤라이나	general, electrical, plumbing, hvac
TN	테네시	general, electrical, plumbing
TX	텍사스	hvac, electrical, plumbing
UT	유타	general, electrical, plumbing, hvac
VA	버지니아	general, electrical, plumbing, hvac
VT	버몬트	electrical, plumbing
WA	워싱턴	general
WV	웨스트버지니아	general, electrical, hvac, plumbing

지원 범위는 지속적으로 확대됩니다. 에이전트에서 clv_list_supported_states를 실행하여 현재 목록을 확인하거나 www.tradesapi.com에서 실시간 주 그리드를 확인하세요.

구성

변수	필수	설명
`CLV_API_URL`	예	API 백엔드 URL (`https://www.tradesapi.com` 사용)
`CLV_API_KEY`	예	대시보드에서 발급받은 API 키

크레딧

각 면허 검증은 결과가 최신이든 캐시된 것이든 상관없이 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

contractor-license-mcp-server

contractor-license-mcp-server

이 서버를 사용하는 이유

빠른 시작

Claude Desktop

API 키 발급받기

직접 설치

도구

`clv_verify_license`

`clv_batch_verify`

`clv_list_supported_states`

지원되는 주

구성

크레딧

개발

라이선스

Resources

Tools

Latest Blog Posts

MCP directory API