# Texas Contractor License Verifier — MCP Server

## Overview
An MCP (Model Context Protocol) server that verifies Texas plumbing contractor licenses in real-time. Powered by official TSBPE (Texas State Board of Plumbing Examiners) data with 86,849 active records across 6 license types.

## Features
- **verify_license** — Search by contractor name (last name, full name)
- **verify_by_license_number** — Look up by license number
- **search_by_county** — Find licensed plumbers in a specific Texas county
- **list_supported_states** — Free discovery tool showing coverage

## Pricing
$0.05 per data query (USDC via x402 protocol). Discovery tools (list_supported_states) are free.

## Data Source
Official TSBPE public CSV downloads from tsbpe.texas.gov. Auto-updated weekly via cron job (Sundays at 3am CST).

### License Types Covered
- Responsible Master Plumber (9,344 records)
- Master Plumber (4,328 records)
- Journeyman Plumber (26,209 records)
- Tradesman Plumber-Limited (3,578 records)
- Plumber's Apprentice (41,566 records)
- Plumbing Inspector (1,824 records)

## Connection
```
URL: http://149.28.238.172:8787/mcp
Transport: Streamable HTTP (POST)
```

## Payment
This server uses the x402 payment protocol. Agents must:
1. Call tools/list (free) to discover available tools
2. Call verify_license/verify_by_license_number/search_by_county → receive 402 Payment Required
3. Pay $0.05 USDC on Base (testnet: Base Sepolia, mainnet: Base)
4. Retry with X-PAYMENT header containing the payment payload
5. Receive the verified data

## Technical
- Built with FastMCP (Python) + Starlette x402 middleware
- SQLite database with indexed lookups
- PM2 process management with auto-restart
- Weekly auto-updater for fresh TSBPE data
- Facilitator: x402.org (testnet) / Coinbase CDP (mainnet)