# LicenseGround

> Deterministic trade contractor license verification & compliance gating for autonomous AI agents.

- name: com.licenseground/licenseground
- version: 1.0.1
- connection class: R0 (autonomous)
- trust: 83/100 flags: no-repository
- quality: 70/100 (needs work)
- owner: not claimed
- descriptor: https://api.protogrid.dev/v1/servers/com.licenseground%2Flicenseground
- tools: https://api.protogrid.dev/v1/servers/com.licenseground%2Flicenseground/tools

**An agent can connect right now, no human step.** Remote endpoint, no authentication, reachable on the last probe.

## Connection (mcpServers)

```json
{
  "mcpServers": {
    "licenseground": {
      "type": "http",
      "url": "https://licenseground.com/mcp",
      "headers": {
        "X-Agent-Key": "${X_AGENT_KEY}"
      }
    }
  }
}
```

Placeholders to fill: `${X_AGENT_KEY}`.

## Trust

- hygiene: 80
- liveness: 100
- freshness: 100
- provenance: 55
- drivers: +dns-namespace +website +reachable +uptime-100% +updated-20d-ago -no-repository
- Derived from observable signals (official registry feed and our own credential-free probes); no code audit performed.

## Quality 70/100 (needs work)

### protocol: 75 (weight 25)

- warn `protocol.modern`: newest supported version is 2025-11-25; 2026-07-28 not supported, older versions are deprecated until 2027-07-28
- n/a `protocol.stateless`: only applies to 2026-07-28 servers
- pass `protocol.transport`: streamable HTTP
- n/a `protocol.list_ttl`: only applies to 2026-07-28 servers

### authorization: n/a (weight 15)

- n/a `auth.prm`, `auth.as_metadata`, `auth.cimd`: no remote uses OAuth
- n/a `auth.secret_in_url`: no templated URL

### tool hygiene: 64 (weight 30)

- pass `tools.descriptions`: every tool has a description
- warn `tools.description_length`: 1 tools have descriptions over 1,024 characters, which crowds the context
- pass `tools.schemas`: every tool has an object input schema
- fail `tools.annotations`: no tool declares readOnlyHint or destructiveHint, so clients cannot tell safe calls from risky ones
- fail `tools.directory_hints`: no tool declares all four of readOnlyHint, destructiveHint, idempotentHint and openWorldHint; missing: check_compliance_risk (readOnlyHint, destructiveHint, idempotentHint, openWorldHint); search_contractors (readOnlyHint, destructiveHint, idempotentHint, openWorldHint); get_registry_status (readOnlyHint, destructiveHint, idempotentHint, openWorldHint); …
- pass `tools.token_cost`: about 1,332 tokens to load every tool
- pass `tools.api_dump`: tools are not a one-to-one API dump

### stability: 75 (weight 15)

- warn `stability.changes`: 12 tool changes in 30 days
- pass `stability.rug_pull`: no tool changed its meaning under the same name

### dependencies: n/a (weight 15)

- n/a `deps.known_vulns`, `deps.mcp_sdk_version`, `deps.resolvable`: no npm or PyPI package

- tools: 6, about 1,332 tokens to load them all
- tool set hash: 4078a4644fa9823efcc2d169d22959f8
- tools last changed: 2026-09-30T17:56:12.288Z
- badge: [![protogrid quality](https://protogrid.dev/badge/com.licenseground/licenseground.svg)](https://protogrid.dev/servers/com.licenseground/licenseground)
- Checks run on what our credential-free, read-only probes observe; tools are never called and no code audit is performed.

### Tool changes

- 2026-09-30 `get_registry_status` added
  - Check the system health, cache performance statistics, and multi-state registry connectivity. Returns: JSON object with cache hit/miss counts, total records cached, and connector status for CA, FL, TX, NY, MA, IL, AZ.
- 2026-09-30 `audit_osha_safety` added
  - Audit contractor worksite safety history against the OSHA inspection and enforcement database. Evaluates willful safety violations, repeat fall protection citations, and cumulative penalties. Args: entity_name: Official business or entity name to evaluate.
- 2026-09-30 `check_federal_debarment` added
  - Check if a contractor is actively debarred or suspended on the federal SAM.gov Excluded Parties List System (EPLS). Crucial for public contracts, infrastructure, and enterprise B2B compliance. Args: entity_name: Official business or entity name to evaluate against federal sanctions.
- 2026-09-30 `search_contractors` added
  - Discover active, verified trade contractors in California, Florida, or Texas by trade classification and location. Args: state: Two-letter US state code ('CA', 'FL', or 'TX'). Required. trade: Trade category ('roofing', 'hvac', 'electrical', 'plumbing', 'general_contractor'). Required. city: Optional city to filter contractors by location. limit: Maximum number of contractors to return (1 to 50, default 10). Returns: JSON list of verified contractors with active licenses, phone numbers, and addresses.
- 2026-09-30 `check_compliance_risk` added
  - Perform an automated compliance and liability risk assessment for autonomous onboarding, hiring, or payments. Args: state: Two-letter US state code ('CA', 'FL', or 'TX'). Required. entity_name: Company name or DBA to assess. license_number: State license number to assess. trade: Trade category: 'roofing', 'hvac', 'electrical', 'plumbing', 'general_contractor', or 'any'. require_workers_comp: If true, fails compliance if no verified workers' comp policy is active on file. require_surety_bond: If true, fails compliance if contractor bond is inactive or missing. max_disciplinary_actions: Maximum allowed board citations or disciplinary orders (default 0). min_confidence_score: Minimum entity name match confidence threshold (0.0 to 1.0, default 0.85). Returns: JSON with 'can_hire' boolean, 'risk_level' ('LOW', 'MEDIUM', 'HIGH', 'CRITICAL'), 'risk_score' (0.0 to 100.0), specific 'flags', and the full underlying verification result.
- 2026-09-30 `verify_license` added
  - Verify an entity's trade contractor license against the official state licensing board (CSLB, DBPR, or TDLR). Args: state: Two-letter US state code ('CA', 'FL', or 'TX'). Required. entity_name: The company name, DBA, or contractor name to verify (e.g. 'Apex Roofing LLC'). license_number: The official state license or certificate ID (e.g. '1058291', 'CCC1330999', 'TACLA29188C'). trade: Trade category: 'roofing', 'hvac', 'electrical', 'plumbing', 'general_contractor', or 'any'. Default is 'any'. city: Optional city to filter geographic disambiguation. Returns: Deterministic, machine-actionable JSON containing verification status, canonical name, active standing, disciplinary action count, workers' compensation status, bond status, and confidence score.
- 2026-09-30 `get_registry_status` removed
  - Check the system health, cache performance statistics, and multi-state registry connectivity. Returns: JSON object with cache hit/miss counts, total records cached, and connector status for CA, FL, TX, NY, MA, IL, AZ.
- 2026-09-30 `audit_osha_safety` removed
  - Audit contractor worksite safety history against the OSHA inspection and enforcement database. Evaluates willful safety violations, repeat fall protection citations, and cumulative penalties. Args: entity_name: Official business or entity name to evaluate.
- 2026-09-30 `check_federal_debarment` removed
  - Check if a contractor is actively debarred or suspended on the federal SAM.gov Excluded Parties List System (EPLS). Crucial for public contracts, infrastructure, and enterprise B2B compliance. Args: entity_name: Official business or entity name to evaluate against federal sanctions.
- 2026-09-30 `search_contractors` removed
  - Discover active, verified trade contractors in California, Florida, or Texas by trade classification and location. Args: state: Two-letter US state code ('CA', 'FL', or 'TX'). Required. trade: Trade category ('roofing', 'hvac', 'electrical', 'plumbing', 'general_contractor'). Required. city: Optional city to filter contractors by location. limit: Maximum number of contractors to return (1 to 50, default 10). Returns: JSON list of verified contractors with active licenses, phone numbers, and addresses.

Full history: https://api.protogrid.dev/v1/servers/com.licenseground%2Flicenseground/changes

## Remotes

- https://licenseground.com/mcp (streamable-http, auth none, reachable true, uptime30d 0.975)
- https://licenseground.com/mcp/sse (sse, auth none, reachable true, uptime30d 1)

## Packages

_none_

## Tools (6)

- `audit_osha_safety`: 
    Audit contractor worksite safety history against the OSHA inspection and enforcement database.
    Evaluates willful safety violations, repeat fall protection citations, and cumulative penalties.

    Args:
        entity_name: Official business or entity name to evaluate.
    
- `check_compliance_risk`: 
    Perform an automated compliance and liability risk assessment for autonomous onboarding, hiring, or payments.

    Args:
        state: Two-letter US state code ('CA', 'FL', or 'TX'). Required.
        entity_name: Company name or DBA to assess.
        license_number: State license number to assess.
        trade: Trade category: 'roofing', 'hvac', 'electrical', 'plumbing', 'general_contractor', or 'any'.
        require_workers_comp: If true, fails compliance if no verified workers' comp policy is active on file.
        require_surety_bond: If true, fails compliance if contractor bond is inactive or missing.
        max_disciplinary_actions: Maximum allowed board citations or disciplinary orders (default 0).
        min_confidence_score: Minimum entity name match confidence threshold (0.0 to 1.0, default 0.85).

    Returns:
        JSON with 'can_hire' boolean, 'risk_level' ('LOW', 'MEDIUM', 'HIGH', 'CRITICAL'),
        'risk_score' (0.0 to 100.0), specific 'flags', and the full underlying verification result.
    
- `check_federal_debarment`: 
    Check if a contractor is actively debarred or suspended on the federal SAM.gov Excluded Parties List System (EPLS).
    Crucial for public contracts, infrastructure, and enterprise B2B compliance.

    Args:
        entity_name: Official business or entity name to evaluate against federal sanctions.
    
- `get_registry_status`: 
    Check the system health, cache performance statistics, and multi-state registry connectivity.

    Returns:
        JSON object with cache hit/miss counts, total records cached, and connector status for CA, FL, TX, NY, MA, IL, AZ.
    
- `search_contractors`: 
    Discover active, verified trade contractors in California, Florida, or Texas by trade classification and location.

    Args:
        state: Two-letter US state code ('CA', 'FL', or 'TX'). Required.
        trade: Trade category ('roofing', 'hvac', 'electrical', 'plumbing', 'general_contractor'). Required.
        city: Optional city to filter contractors by location.
        limit: Maximum number of contractors to return (1 to 50, default 10).

    Returns:
        JSON list of verified contractors with active licenses, phone numbers, and addresses.
    
- `verify_license`: 
    Verify an entity's trade contractor license against the official state licensing board (CSLB, DBPR, or TDLR).

    Args:
        state: Two-letter US state code ('CA', 'FL', or 'TX'). Required.
        entity_name: The company name, DBA, or contractor name to verify (e.g. 'Apex Roofing LLC').
        license_number: The official state license or certificate ID (e.g. '1058291', 'CCC1330999', 'TACLA29188C').
        trade: Trade category: 'roofing', 'hvac', 'electrical', 'plumbing', 'general_contractor', or 'any'. Default is 'any'.
        city: Optional city to filter geographic disambiguation.

    Returns:
        Deterministic, machine-actionable JSON containing verification status, canonical name,
        active standing, disciplinary action count, workers' compensation status, bond status, and confidence score.