Skip to main content
Glama
bdzgroup12

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: license-verify-mcp

🛠️ 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.

Related MCP Connectors

Related MCP Servers