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
- Clone the repository:
cd /Users/adamavery/us-gambling-regulations-mcp/
- Install dependencies:
npm install
- Build the TypeScript server:
npx tsc
- Configure Claude Desktop:
Add to ~/Library/Application Support/Claude/claude_desktop_config.json:
{
"mcpServers": {
"us-gambling-regulations": {
"command": "node",
"args": ["/Users/adamavery/us-gambling-regulations-mcp/build/index.js"]
}
}
}
- 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 jurisdictionlicense_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:
{
"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
- Research state gambling regulations thoroughly
- Create comprehensive data file using the template structure
- Ensure
state_namefield uses lowercase, hyphenated format - Target 90%+ completeness score
- Include all sections: licensing, fees, taxes, compliance, market data, enforcement, contacts
Updating Existing States
- Modify the JSON file in
/data/states/completed/ - Update
data_extraction_datefield - Rebuild TypeScript:
npx tsc - Restart Claude Desktop
Testing
After making changes:
npx tsc
# Restart Claude Desktop
# Test with: "Get license types for [state-name]"
Data Quality Standards
For 90%+ completeness:
- Comprehensive license types - All categories with fees, requirements, durations
- Tax structure - Rates, bases, collection frequency, revenue allocation
- Fee calculations - Breakdowns for all license types
- Compliance requirements - Responsible gaming, age verification, geolocation, internal controls, reporting
- Market data - Launch dates, handle/revenue, current operators
- Enforcement - Regulatory authority, penalties, recent actions
- Application process - Steps, timeline, forms required
- Contact information - Regulator details, problem gambling resources
- Regulatory updates - Recent changes, upcoming legislation
- 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:
- Identify lowest completion state
- Research regulations thoroughly
- Create comprehensive enhancement script
- Test and verify completeness
- 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