# US Gambling Regulations MCP Server
A Model Context Protocol (MCP) server providing comprehensive gambling licensing information across US states, UK, Spain, Malta, and Gibraltar.
## Overview
This MCP server provides detailed, up-to-date information about gambling regulations, licensing requirements, fees, and compliance obligations across US states. It's designed to help legal professionals, gaming operators, compliance officers, and researchers access accurate US regulatory data quickly.
## Features
### US State Coverage (32 States)
Comprehensive data for 32 US states including:
- License types and categories
- Application and renewal fees
- Tax structures and rates
- Compliance requirements
- Market data and statistics
- Regulatory contact information
- Problem gambling resources
### Key Capabilities
- **License Information** - Detailed breakdown of all license types per jurisdiction
- **Fee Calculations** - Calculate licensing fees based on projected revenue
- **Compliance Requirements** - Comprehensive compliance obligations
- **Jurisdiction Comparisons** - Compare regulations across states/countries
- **Market Data** - Launch dates, revenue statistics, operator counts
- **Recent Updates** - 2024-2025 regulatory changes
## Installation
### Prerequisites
- Node.js 18 or higher
- npm or yarn
- Claude Desktop app
### Setup
1. **Clone the repository:**
```bash
cd /Users/adamavery/us-gambling-regulations-mcp/
```
2. **Install dependencies:**
```bash
npm install
```
3. **Build the TypeScript server:**
```bash
npx tsc
```
4. **Configure Claude Desktop:**
Add to `~/Library/Application Support/Claude/claude_desktop_config.json`:
```json
{
"mcpServers": {
"us-gambling-regulations": {
"command": "node",
"args": ["/Users/adamavery/us-gambling-regulations-mcp/build/index.js"]
}
}
}
```
5. **Restart Claude Desktop**
## Available Tools
### US State Tools
#### `us-gambling-regulations:get_license_types`
Get detailed information about gambling license types for a specific US state.
**Parameters:**
- `state` (string, required): State jurisdiction (use kebab-case: new-jersey, pennsylvania, nevada, etc.)
**Example:**
```
Get license types for New Jersey
```
#### `us-gambling-regulations:calculate_fees`
Calculate licensing fees based on projected revenue for a specific state.
**Parameters:**
- `state` (string, required): State jurisdiction
- `license_type` (string, required): Type of license (e.g., 'sports-betting', 'online-casino')
- `projected_revenue` (number, required): Projected annual gross gaming revenue in USD
**Example:**
```
Calculate sports betting fees for Pennsylvania with projected revenue of $50 million
```
#### `us-gambling-regulations:compare_jurisdictions`
Compare gambling regulations between multiple states.
**Parameters:**
- `states` (array, required): List of states to compare (minimum 2)
- `aspect` (string, required): Aspect to compare - 'licensing', 'fees', 'compliance', 'taxes', or 'all'
**Example:**
```
Compare licensing requirements between New Jersey, Pennsylvania, and Nevada
```
#### `us-gambling-regulations:get_compliance_requirements`
Get specific compliance requirements for one or more states.
**Parameters:**
- `states` (array, required): List of state jurisdictions
**Example:**
```
What are the compliance requirements for online casino operators in Michigan?
```
#### `us-gambling-regulations:get_regulatory_updates`
Get recent regulatory changes and updates for specific states.
**Parameters:**
- `states` (array, required): States to get updates for
**Example:**
```
Show me recent regulatory updates for Illinois and New York
```
#### `us-gambling-regulations:calculate_market_size`
Calculate potential market size and revenue projections for a state.
**Parameters:**
- `state` (string, required): State jurisdiction
**Example:**
```
What's the market size projection for sports betting in Ohio?
```
## State Coverage
### Fully Enhanced States (90%+ Complete)
- Arkansas (92%)
- Louisiana (92%)
- Illinois (90%)
- Nevada (90%)
- New Jersey (90%)
- Pennsylvania (90%)
- Michigan (100%)
### Well-Documented States (85-89%)
- Arizona (85%)
- Colorado (80%+)
- Connecticut (65%+)
- Delaware (85%)
- Florida (85%)
- Indiana (88%)
- Iowa (85%)
- Kansas (78%+)
- Kentucky (83%)
- Maine (~85-90%)
- Maryland (80%+)
- Massachusetts (82%)
- Mississippi (~85-90%)
- New Hampshire (75%+)
- New York (88%)
- North Carolina (82%)
- Ohio (85%)
- Oregon (70-75%+)
- Rhode Island (88%)
- Tennessee (85%)
- Vermont (~85-88%)
- Virginia (85%)
- Washington (88%)
- Washington DC (~85-88%)
- West Virginia (85%)
- Wyoming (85%)
- Puerto Rico (~85-88%)
## Data Structure
State data files are located in `/data/states/completed/[state-name].json`
Each state file includes:
```json
{
"state_name": "state-name",
"state": "State Name",
"state_code": "XX",
"regulator": "Regulatory Authority Name",
"regulation_source": "Legal citations",
"license_types": {
"license_type_id": {
"description": "...",
"eligibility": [...],
"application_fee": 0,
"requirements": [...]
}
},
"tax_structure": {...},
"compliance_requirements": {...},
"market_data": {...},
"enforcement": {...},
"contact_information": {...},
"data_quality": {
"completeness_score": 90,
"data_extraction_date": "2025-10-08"
}
}
```
## Development
### Adding New States
1. Research state gambling regulations thoroughly
2. Create comprehensive data file using the template structure
3. Ensure `state_name` field uses lowercase, hyphenated format
4. Target 90%+ completeness score
5. Include all sections: licensing, fees, taxes, compliance, market data, enforcement, contacts
### Updating Existing States
1. Modify the JSON file in `/data/states/completed/`
2. Update `data_extraction_date` field
3. Rebuild TypeScript: `npx tsc`
4. Restart Claude Desktop
### Testing
After making changes:
```bash
npx tsc
# Restart Claude Desktop
# Test with: "Get license types for [state-name]"
```
## Data Quality Standards
For 90%+ completeness:
1. **Comprehensive license types** - All categories with fees, requirements, durations
2. **Tax structure** - Rates, bases, collection frequency, revenue allocation
3. **Fee calculations** - Breakdowns for all license types
4. **Compliance requirements** - Responsible gaming, age verification, geolocation, internal controls, reporting
5. **Market data** - Launch dates, handle/revenue, current operators
6. **Enforcement** - Regulatory authority, penalties, recent actions
7. **Application process** - Steps, timeline, forms required
8. **Contact information** - Regulator details, problem gambling resources
9. **Regulatory updates** - Recent changes, upcoming legislation
10. **Competitive analysis** - Market strengths and challenges
## Use Cases
### Legal Research
"What are the licensing requirements for online sports betting in Pennsylvania?"
### Fee Planning
"Calculate the licensing fees for an online casino in New Jersey with projected revenue of $25 million"
### Market Entry Analysis
"Compare sports betting regulations between Illinois, Michigan, and Ohio"
### Compliance Assessment
"What are the responsible gaming requirements for operators in Nevada?"
### Market Intelligence
"Show me the market size and operator count for sports betting in New York"
## Contributing
State enhancement workflow:
1. Identify lowest completion state
2. Research regulations thoroughly
3. Create comprehensive enhancement script
4. Test and verify completeness
5. Document completion score increase
## Support
For questions or issues:
- Check state data files in `/data/states/completed/`
- Verify Claude Desktop configuration
- Ensure TypeScript is compiled: `npx tsc`
- Restart Claude Desktop after changes
## License
[Add your license information]
## Changelog
### October 2025
- Enhanced 6 states to 80%+ completion: Connecticut, Oregon, New Hampshire, Kansas, Colorado, Maryland
- Fixed Arkansas (45% → 92%) and Louisiana (78% → 92%)
- Added comprehensive compliance requirements
- Updated market data through Q3 2025
- Added 2024-2025 regulatory changes
### Recent Updates
- 32 states in database
- UK, Spain, Malta, Gibraltar coverage
- Fee calculation tools
- Market size projections
- Regulatory update tracking
## Roadmap
- [ ] Enhance remaining states to 90%+ completion
- [ ] Add tribal gaming compact details
- [ ] Include historical regulatory timeline
- [ ] Add license application checklists
- [ ] Include sample compliance documents
---
**Current Status:** 32 US states, 12 states at 90%+ completion
