Skip to main content
Glama
LicenseGround MCP Server

LicenseGround MCP Server

LicenseGround MCP Server

License: MIT Python 3.10+ MCP Transport

Official Model Context Protocol (MCP) client connector for LicenseGround: providing AI agents, autonomous procurement systems, and invoice dispatchers with real-time, machine-readable regulatory ground truth for US trade contractors.


⚡️ Quickstart: Connect to the Cloud Server (Zero Install)

You do not need to install Python or maintain local packages to use LicenseGround. Connect directly to our high-availability cloud endpoint:

1. Claude Desktop

Add this to your claude_desktop_config.json:

{
  "mcpServers": {
    "licenseground": {
      "url": "https://licenseground.com/mcp",
      "headers": {
        "X-Agent-API-Key": "YOUR_LICENSEGROUND_API_KEY"
      }
    }
  }
}

Config file locations:

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

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

2. Cursor / Windsurf / Claude Code

Add a new MCP server in your IDE settings:

  • Name: licenseground

  • Type: Streamable HTTP (or SSE)

  • Endpoint URL: https://licenseground.com/mcp

  • Custom Headers: X-Agent-API-Key: YOUR_LICENSEGROUND_API_KEY

3. Smithery CLI

Install directly via Smithery:

npx -y @smithery/cli install licenseground --client claude

Related MCP server: BizVerify MCP Server

🛠️ Available MCP Tools

Tool

Description

verify_license

Direct regulatory inquiry against official licensing boards (California CSLB, Florida DBPR, Texas TDLR, New York DOB, Massachusetts CSL, Illinois Chicago DOB, Arizona ROC). Returns license status, expiration, classifications, disciplinary flags, and workers' comp insurance.

check_compliance_risk

Comprehensive composite risk evaluation for autonomous onboarding or accounts payable. Audits license standing, workers' comp coverage, surety bonds, OSHA citations, and SAM.gov debarment to output a deterministic can_hire score and flags.

search_contractors

Discover active, verified trade contractors by trade classification, state, and geographic proximity across supported jurisdictions.

check_federal_debarment

Checks the Federal SAM.gov System for Award Management exclusion list for debarred entities, active exclusions, and SAM unique entity identifiers.

audit_osha_safety

Inspects official OSHA safety records for active investigations, standard violations, serious citations, and penalty history.

get_registry_status

Returns system latency, cache hit statistics, and board scraping health metrics across all supported jurisdictions.


💻 Local Stdio Connector

If your agent runtime requires a local stdio subprocess:

1. Clone & Install Dependencies

git clone https://github.com/bdzgroup12/licenseground.git
cd licenseground
pip install -r requirements.txt

2. Configure Environment

Copy .env.example to .env or export your API key:

export LICENSEGROUND_API_KEY="your_licenseground_api_key"

(Get your API key at licenseground.com)

3. Run via Stdio

python -m src.server

4. Claude Desktop Stdio Config

{
  "mcpServers": {
    "licenseground": {
      "command": "python",
      "args": ["-m", "src.server"],
      "cwd": "/path/to/licenseground",
      "env": {
        "LICENSEGROUND_API_KEY": "your_licenseground_api_key"
      }
    }
  }
}

🐳 Docker

Run with Docker:

docker build -t licenseground-mcp .
docker run -i --rm -e LICENSEGROUND_API_KEY="your_api_key" licenseground-mcp

📄 License

This client package is licensed under the MIT License - see the LICENSE file for details.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      A
      quality
      D
      maintenance
      Real-time contractor license verification across 45 US states. Verifies license status, expiration, and disciplinary history directly against state licensing board portals.
      4
      53 npm
      MIT
    • A
      license
      A
      quality
      D
      maintenance
      Enables AI agents to verify and search business entities across US state and international company registries, providing real-time confirmation of legal existence, status, and filings.
      9
      MIT
    • A
      license
      A
      quality
      B
      maintenance
      Enables AI agents to search and retrieve US government contracts, look up NAICS codes, list indexed states, and score contract fit for a business profile. Provides access to live state and local procurement data through natural language without raw HTTP.
      7
      72 npm
      MIT
    • A
      license
      A
      quality
      C
      maintenance
      Enables checking Québec contractors in one call — RBQ licence status, RENA debarment, environmental penalties, and SEAO public contracts — returning a deterministic ok/review/blocking/not_found verdict with sources. Paid per-call tools add web search with full page text and business verification against sanctions, corporate registries, and GLEIF data.
      2
      48 npm
      MIT