# License Verifier MCP Server 🪙

50-state professional license verification for AI agents.

## Why This Exists

Every healthcare transaction, real estate deal, or legal engagement requires verifying professional licenses. Today that means manually checking 50+ different state websites — each with different interfaces, data formats, and quirks.

This MCP server wraps all 50 state licensing boards into a single, unified API that any AI agent can call.

## Features

- **Unified Schema**: Consistent response format regardless of source state
- **50-State Coverage**: Physicians, nurses, lawyers, contractors, real estate agents
- **Multi-Profession**: Medical, Legal, Nursing, Pharmacy, Dental, and more
- **Real-Time Verification**: Direct queries to state boards (with caching)
- **Disciplinary Actions**: Includes suspensions, revocations, board orders
- **x402 Micropayments**: Pay-per-call via Base USDC

## Supported Professions

| Profession | States | Status |
|------------|--------|--------|
| Physicians (MD/DO) | CA, TX, FL, NY | 🟢 Live |
| Attorneys | CA | 🟢 Live |
| Nurses (RN/LPN) | CA, TX, FL, NY | 🟢 Live |
| Physician Assistants | CA, TX, FL, NY | 🟢 Live |
| Pharmacists | CA, FL, NY | 🟡 Beta |
| Dentists | CA, FL | 🟡 Beta |

## Tools

### `verify_license`
Verify a specific license in a specific state.

```json
{
  "state": "CA",
  "licenseNumber": "A12345",
  "licenseType": "MD"
}
```

### `search_license`
Search for a license across multiple states.

```json
{
  "name": "John Smith",
  "licenseType": "MD",
  "states": ["CA", "TX", "NY"]
}
```

### `list_supported_states`
List all supported states and their capabilities.

## Pricing

| Tier | Price | Calls |
|------|-------|-------|
| Free | $0 | 100/month |
| Pro | $49/mo | 10,000/month |
| Pay-per-call | $0.50-$1.50 | x402 micropayment |

## Installation

```bash
npm install license-verifier-mcp
```

## Usage

Add to your MCP client config:

```json
{
  "mcpServers": {
    "license-verifier": {
      "command": "npx",
      "args": ["license-verifier-mcp"]
    }
  }
}
```

## Roadmap

- [x] MCP server scaffold
- [x] State mapping (research)
- [ ] California DCA API integration
- [ ] Texas scraper
- [ ] Florida scraper
- [ ] New York scraper
- [ ] x402 payment middleware
- [ ] Smithery listing
- [ ] Remaining 46 states

## License

MIT

---

Built by Mint 🪙