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:

cd /Users/adamavery/us-gambling-regulations-mcp/

2. Install dependencies:

npm install

3. Build the TypeScript server:

npx tsc

4. 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"]
    }
  }
}

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:

{
  "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:

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