contractor-license-mcp-server

跨 45 个美国州的实时承包商执照验证。 这是一个 MCP 服务器，允许 Claude Desktop、Cursor 以及任何支持 MCP 的 AI 代理直接针对州许可委员会门户网站验证承包商的执照、状态、有效期和纪律处分记录。

发送 {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`	是	两位州代码 (`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	哥伦比亚特区	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