Licensy

Official9 toolsLive

by licensy

Real-time U.S. medical license verification across all 50 states + DC.

ai.licensy/mcp-server (MCP Server)

The ai.licensy/mcp-server provides real-time U.S. medical license verification across all 50 states plus the District of Columbia (DC). It is exposed via an MCP server interface and includes 9 tools for performing license checks.

🛠️ Key Features

Real-time medical license verification
Coverage across all 50 U.S. states and DC
MCP server with 9 available tools

🚀 Use Cases

Verifying whether a medical license is current by state or DC
Supporting workflows that require up-to-date license status during compliance checks

⚡ Developer Benefits

Use MCP tools to integrate license verification into developer systems
Designed for broad U.S. jurisdiction coverage (50 states + DC)

⚠️ Limitations

Source material does not list specific tools, inputs/outputs, authentication, latency bounds, or rate limits.

Captured live from the server via tools/list.

verify_license

Verify a U.S. physician's medical license status in a specific state. Returns current status (active/expired/suspended/etc.), expiration date, and a confidence indicator. Use this when: - Confirming a physician is currently licensed before scheduling care - Validating credentials during onboarding or recredentialing - Answering 'is Dr. X licensed in [state]?' questions Do NOT use this for: - Bulk verification of >1 NPI — use bulk_verify instead (paid tier) - Historical 'was this physician licensed on date X' — use get_license_history instead (paid tier) Input: NPI (preferred) OR (license_number + state), plus state. State accepts either 2-letter code ('CA') or full name ('California'). Output: status, state, expiration_date, license_active. Paid tiers additionally receive license_number, issuance_date, board_source, last_refreshed_at, screenshot_url for audit-grade primary-source verification. Data is sourced directly from state medical boards and refreshed every 24 hours. Licensy covers all 50 states + DC.

Parameters1

inp

object

required

Raw schema

{
  "type": "object",
  "properties": {
    "inp": {
      "properties": {
        "npi": {
          "anyOf": [
            {
              "pattern": "^\\d{10}$",
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "description": "10-digit National Provider Identifier. Preferred input."
        },
        "license_number": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "description": "State-issued license number. Use when NPI is not known."
        },
        "state": {
          "description": "Two-letter US state code (e.g. 'CA') OR full state name (e.g. 'California'). All 50 states + DC supported.",
          "maxLength": 20,
          "minLength": 2,
          "type": "string"
        },
        "license_type": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "description": "Optional credential filter: MD, DO, PA, APRN, RN, CNP, CRNA, CNS, CNM."
        }
      },
      "required": [
        "state"
      ],
      "type": "object"
    }
  },
  "required": [
    "inp"
  ],
  "additionalProperties": false
}

list_physician_licenses

List all U.S. medical licenses Licensy has on file for a single physician (by NPI), one per state. Each entry shows current status and expiration date. Use this when: - Surveying a physician's multi-state license portfolio - Recredentialing across multiple states at once - Checking which states a physician is licensed in Do NOT use this for: - A single-state yes/no — use get_license_status (cheaper) - Bulk verification across multiple NPIs — use bulk_verify Input: NPI (10 digits). Optional include_inactive flag (default false). Output: array of {status, state, expiration_date, license_active}. Free tier returns these summary fields. Paid tier callers receive the full license record per state.

Parameters1

inp

object

required

Raw schema

{
  "type": "object",
  "properties": {
    "inp": {
      "properties": {
        "npi": {
          "description": "10-digit NPI.",
          "pattern": "^\\d{10}$",
          "type": "string"
        },
        "include_inactive": {
          "default": false,
          "description": "If true, include expired/lapsed/inactive licenses in the response.",
          "type": "boolean"
        }
      },
      "required": [
        "npi"
      ],
      "type": "object"
    }
  },
  "required": [
    "inp"
  ],
  "additionalProperties": false
}

get_license_status

Return only the license status string for a single physician in a single state. The minimal-output companion to verify_license: optimized for agents that need only a yes/no decision and want to minimize tokens in the LLM context. Use this when: - You need a one-word answer for routing logic (active vs anything else) - You're checking a license inside a tight inner loop - You want to minimize tokens spent on auxiliary fields Use verify_license instead when you need expiration date, license_active boolean, or any other field. Input: NPI (10 digits), state. Output: a single status from the controlled vocabulary: active | expired | lapsed | inactive | suspended | revoked | surrendered | pending | not_found.

Parameters1

inp

object

required

Raw schema

{
  "type": "object",
  "properties": {
    "inp": {
      "properties": {
        "npi": {
          "pattern": "^\\d{10}$",
          "type": "string"
        },
        "state": {
          "maxLength": 20,
          "minLength": 2,
          "type": "string"
        }
      },
      "required": [
        "npi",
        "state"
      ],
      "type": "object"
    }
  },
  "required": [
    "inp"
  ],
  "additionalProperties": false
}

get_screenshot_url

Return an audit-grade screenshot of the state medical board page used to verify a physician's license. The URL is signed and valid for 15 minutes. Use this when: - You need primary-source evidence for an audit, credentialing file, or insurance contract - The end user asks 'where did this come from?' - You're generating a credentialing PDF that needs proof attachments Identify the license by: NPI + state, OR by `license_id` if you already fetched it via verify_license / list_physician_licenses. Free-tier callers receive a structured tier_upgrade_required response. Paid tier (Pro / Enterprise) only.

Parameters1

inp

object

required

Raw schema

{
  "type": "object",
  "properties": {
    "inp": {
      "properties": {
        "npi": {
          "anyOf": [
            {
              "pattern": "^\\d{10}$",
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null
        },
        "state": {
          "anyOf": [
            {
              "maxLength": 20,
              "minLength": 2,
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null
        },
        "license_id": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "description": "Licensy internal license_id. Use this when you previously fetched a license via verify_license and want the screenshot for that exact row."
        }
      },
      "type": "object"
    }
  },
  "required": [
    "inp"
  ],
  "additionalProperties": false
}

bulk_verify

Verify medical licenses for many (NPI, state) pairs in a single call. Returns one result per input, in input order. Use this instead of calling verify_license in a loop — bulk_verify parallelises server-side, returns faster, and is billed as a single call. Limits: Pro tier max 100 pairs per call; Enterprise max 1000. Use this when: - Initial roster ingestion for a credentialing project - Quarterly recredentialing audit of a multi-state group - Pre-call verification of a physician list before scheduling Paid tier only (Pro or Enterprise).

Parameters1

inp

object

required

Raw schema

{
  "type": "object",
  "properties": {
    "inp": {
      "properties": {
        "licenses": {
          "description": "Up to 100 (Pro) or 1000 (Enterprise) NPI+state pairs.",
          "items": {
            "properties": {
              "npi": {
                "pattern": "^\\d{10}$",
                "type": "string"
              },
              "state": {
                "maxLength": 20,
                "minLength": 2,
                "type": "string"
              }
            },
            "required": [
              "npi",
              "state"
            ],
            "type": "object"
          },
          "type": "array"
        }
      },
      "required": [
        "licenses"
      ],
      "type": "object"
    }
  },
  "required": [
    "inp"
  ],
  "additionalProperties": false
}

search_disciplinary_actions

Search for known disciplinary actions against a physician (suspension, revocation, surrender, probation). Sourced from state medical board status text. Use this when: - Pre-employment screening - Recredentialing — required by most insurance contracts - Investigating a referral source Input: NPI (preferred) OR full name. Optional state filter. Output: array of {state, action_type, date, source_url}. Action types: suspension | revocation | surrender | probation | reprimand | other. Coverage note: this surfaces board-status-level signal. Underlying PDF documents are on the roadmap. Paid tier only (Pro or Enterprise).

Parameters1

inp

object

required

Raw schema

{
  "type": "object",
  "properties": {
    "inp": {
      "properties": {
        "npi": {
          "anyOf": [
            {
              "pattern": "^\\d{10}$",
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null
        },
        "name": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "description": "Full name; required if npi not provided."
        },
        "state": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "description": "Optional state filter."
        }
      },
      "type": "object"
    }
  },
  "required": [
    "inp"
  ],
  "additionalProperties": false
}

get_license_history

Return a physician's license status as it was on a specific past date (point-in-time / retroactive lookup). Use this when: - Insurance company asks 'was this physician licensed when they treated patient X on 2024-08-12?' - Legal discovery for a malpractice case - Retroactive credentialing audit Input: NPI + state + as_of_date (ISO 8601). Coverage caveat: full append-only license history is on the roadmap. v1 returns best-available data and a `coverage_start` date marking the earliest reliable point-in-time queries. Paid tier only (Pro or Enterprise).

Parameters1

inp

object

required

Raw schema

{
  "type": "object",
  "properties": {
    "inp": {
      "properties": {
        "npi": {
          "pattern": "^\\d{10}$",
          "type": "string"
        },
        "state": {
          "maxLength": 20,
          "minLength": 2,
          "type": "string"
        },
        "as_of_date": {
          "description": "ISO 8601 date (YYYY-MM-DD).",
          "type": "string"
        }
      },
      "required": [
        "npi",
        "state",
        "as_of_date"
      ],
      "type": "object"
    }
  },
  "required": [
    "inp"
  ],
  "additionalProperties": false
}

subscribe_to_changes

Subscribe a webhook URL to license-change events for one or more NPIs. Licensy POSTs a signed JSON payload to your URL when a subscribed event fires. Events: status_change — license status changes (active → expired, etc.) expiration_warning_60d — license expires in 60 days new_disciplinary_action — new sanction added Status: webhook delivery is on the roadmap. This tool records the subscription intent today; deliveries will begin once the dispatcher ships. Paid tier only (Pro or Enterprise).

Parameters1

inp

object

required

Raw schema

{
  "type": "object",
  "properties": {
    "inp": {
      "properties": {
        "npis": {
          "description": "One or more 10-digit NPIs to watch.",
          "items": {
            "type": "string"
          },
          "type": "array"
        },
        "webhook_url": {
          "description": "HTTPS endpoint to POST events to.",
          "type": "string"
        },
        "events": {
          "description": "Event types to subscribe to.",
          "items": {
            "type": "string"
          },
          "type": "array"
        }
      },
      "required": [
        "npis",
        "webhook_url"
      ],
      "type": "object"
    }
  },
  "required": [
    "inp"
  ],
  "additionalProperties": false
}

unsubscribe

Cancel a webhook subscription you previously created via subscribe_to_changes. Paid tier only (Pro or Enterprise). Use this when the agent's workflow that wanted the events has completed, or the customer wants to stop receiving change-notifications for a set of NPIs. Input: subscription_id (string, returned from subscribe_to_changes). Output: {success: true} on cancellation. Idempotent — repeat calls with the same id return success without error.

Parameters1

inp

object

required

Raw schema

{
  "type": "object",
  "properties": {
    "inp": {
      "properties": {
        "subscription_id": {
          "type": "string"
        }
      },
      "required": [
        "subscription_id"
      ],
      "type": "object"
    }
  },
  "required": [
    "inp"
  ],
  "additionalProperties": false
}

Install

Tools (9)

verify_licenselist_physician_licensesget_license_statusget_screenshot_urlbulk_verifysearch_disciplinary_actionsget_license_historysubscribe_to_changes

Remote endpoint

Streamable HTTP

Hosted server - connect over the network, no local install.

url

https://mcp.licensy.ai/mcp

Add to VS Code Add to Cursor

claude_desktop_config.json

json

{
  "mcpServers": {
    "mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://mcp.licensy.ai/mcp"
      ]
    }
  }
}

Desktop config is stdio-only; this bridges via mcp-remote. Native remote: Settings > Connectors.

ai.licensy/mcp-server (MCP Server)

🛠️ Key Features

🚀 Use Cases

⚡ Developer Benefits

⚠️ Limitations

verify_license

list_physician_licenses

get_license_status

get_screenshot_url

bulk_verify

search_disciplinary_actions

get_license_history

subscribe_to_changes

unsubscribe

Install

Remote endpoint

Related servers