License Verify MCP logo

License Verify MCP

by lmaniraruta

Verifies US contractor licenses, surety bonds, and insurance using official Washington and California state data.

Install License Verify MCP

Pick your client, then add it in one click or paste the config.

STDIONode.js
~/Library/Application Support/Claude/claude_desktop_config.json
claude_desktop_config.json
{
  "mcpServers": {
    "lmaniraruta-license-verify-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "apify"
      ]
    }
  }
}

Settings → Developer → Edit Config, merge this into mcpServers, then fully quit and reopen Claude Desktop.

We couldn’t confirm it starts correctly

The install command didn't complete successfully in our automated test.

npx -y apify

npm ERR! could not determine executable to run npm ERR! A complete log of this run can be found in: /home/user/.npm/_logs/2026-09-25T11_54_11_094Z-debug-0.log

This is an experimental automated check and can have false negatives — missing environment variables, a slow cold install, etc. It doesn’t necessarily mean something’s wrong. Last checked 1mo ago.

Overview

The lmaniraruta/license-verify-mcp MCP server verifies US contractor licenses and can return status, surety bond, and insurance details. It accepts a jurisdiction plus a license number or, for Washington, a business name, then queries official state sources. Washington uses live Socrata datasets from L&I, while California retrieves CSLB HTML and is marked beta. Use it for contractor due diligence when state coverage and source reliability match your workflow.

Use cases

  • Verify a Washington contractor before hiring
  • Check bond and insurance coverage during vendor due diligence
  • Look up a California contractor license with beta-state support
  • List supported jurisdictions before submitting a verification request

Key features

  • Washington L&I live license lookups
  • California CSLB beta lookups
  • Surety bond and insurance details
  • License-number and Washington business-name queries
  • Structured source-failure responses
  • Supported-jurisdiction listing

Tools3

What License Verify MCP lets your agent do. Expand a tool for its parameters.

Self-reported~10 tokens of context

Security & health

What it can reach and how reliably it runs — from our own checks, not the maintainer’s claims.

ActiveLast checked 1d ago

Recent health check succeeded.

17/17 checks healthy over the last 75d

Supply-chain signal

No high-severity advisories surfaced by our automated scan.

Critical 0High 0Medium 0Low 0

Scanned 7d ago via OSV.dev · apify (npm)

Adoption & maintenance

Factual signals from GitHub, npm, and our automated checks — not a rating.

npm downloads250kPackage downloads in the last 30 days.
Last commit3mo agoMost recent push to the default branch.
Install checkInconclusiveInstall command did not finish in our automated test.
Tools exposed3Callable tools this server registers over MCP.
Directory activity5 viewsConfig copies, upvotes, and views on AllMCPs.

How License Verify MCP works

What lmaniraruta/license-verify-mcp MCP server does

The lmaniraruta/license-verify-mcp MCP server checks contractor licensing records for Washington and California. A successful lookup can include the license status, license type, business name, effective and expiration dates, surety bond information, and insurance information. The response also includes the jurisdiction, query details, source URL, retrieval timestamp, and raw source data.

Washington is the production-oriented option. Its provider reads official Washington Department of Labor & Industries open data through Socrata JSON endpoints. The available data includes dedicated bond and insurance datasets. California support is beta and uses the California Contractors State License Board’s HTML detail pages.

How it works

Call verify_license with jurisdiction set to WA or CA and provide at least one lookup value. License numbers are accepted for both jurisdictions. Business-name lookup is available for Washington and supports partial matching, which may produce a matches[] collection.

Results indicate whether a record was found. A found result uses one of these statuses: active, expired, suspended, revoked, or unknown. Bond and insurance fields describe whether matching coverage was found and include source details such as carrier, policy or bond number, amount, coverage, and dates when available.

The lmaniraruta/license-verify-mcp MCP server does not treat a failed source request as a crash. It returns structured errors such as SESSION_ERROR or NETWORK_ERROR. The separate list_supported_jurisdictions tool reports the supported states, their availability, and their data sources.

Setup and configuration

Build and run the lmaniraruta/license-verify-mcp MCP server locally with the repository’s Node.js scripts. The documented sequence is npm install, npm run build, and npm run start:mcp. The MCP process uses stdio. Claude Desktop can launch the compiled server with Node and the path to dist/index.js; that path must be replaced with the local repository path.

The repository also documents an Apify Actor workflow. Its input uses the same jurisdiction and lookup fields. A local Actor test writes an INPUT.json file, builds the project, and runs npx apify run; this is separate from starting the stdio MCP process.

Tools and capabilities

  • verify_license: Looks up a contractor by license number or supported business name.
  • list_supported_jurisdictions: Lists state support, status, and source information.
  • Returns full status, bond, and insurance data when matching records are available.
  • Supports Washington live data and California beta data.
  • Provides structured not-found and source-failure responses.

Limitations and notes

Washington is identified as reliable for production use. California depends on direct CSLB HTML access, and automated requests may be rate-limited or return HTTP 503 responses. The documentation advises against relying on California for production workflows until a stable server-side run is confirmed.

The Actor pricing model charges $0.03 for a successful full result and $0.01 for a successful status-only result. A status-only response can occur when bond or insurance data does not match, or when statusOnly: true is used. Not-found responses, validation errors, and source failures are free. The provided MCP tool description does not document a statusOnly parameter for the stdio tool, so clients should not assume that option is available there.

The project is licensed under MIT. Adding another state requires implementing the repository’s provider interface and registering the provider in the provider index.

Reviews

No reviews yet — be the first to share how it worked for you.

Frequently Asked Questions about License Verify MCP

Clone the repository, run `npm install`, build with `npm run build`, and start the stdio server with `npm run start:mcp`.

Yes. The README provides a Claude Desktop configuration that launches the compiled `dist/index.js` file with Node.

It supports Washington (`WA`) as live coverage and California (`CA`) as beta coverage.

Yes, matching results can include surety bond and insurance details. Washington provides these from dedicated official datasets; California parses them when CSLB is available.

Related MCP servers

Add a badge to your READMEShow it’s listed — live SVG, Markdown or HTML.

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:
Live Dynamic SVG PreviewLicense Verify MCP AllMCPs Directory Badge
Markdown (GitHub README)
[![AllMCPs](https://allmcps.com/api/badge/lmaniraruta-license-verify-mcp?style=directory)](https://allmcps.com/mcp/lmaniraruta-license-verify-mcp)
HTML Embed
<a href="https://allmcps.com/mcp/lmaniraruta-license-verify-mcp"><img src="https://allmcps.com/api/badge/lmaniraruta-license-verify-mcp?style=directory" alt="License Verify MCP on AllMCPs" /></a>