@livhana/age-gate-mcp

MCP server for 21+ age verification and 50-state hemp/cannabis compliance. Fail-closed design -- access denied by default.

Tools

| Tool | Description | |------|-------------| | verify_age | Check if a birth date passes the 21+ minimum age requirement | | check_state | State-level hemp compliance check (legality, THC limits, smokable bans, online sales) | | compliance_matrix | Full 50-state + DC compliance matrix | | age_gate_snippet | Generate embeddable HTML/JS age gate for licensee websites |

Install

npm install -g @livhana/age-gate-mcp

Configure (Claude Desktop)

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "age-gate": {
      "command": "npx",
      "args": ["-y", "@livhana/age-gate-mcp"]
    }
  }
}

Configure (Cursor / VS Code)

Add to your MCP settings:

{
  "age-gate": {
    "command": "npx",
    "args": ["-y", "@livhana/age-gate-mcp"]
  }
}

Transport Modes

Set the MCP_TRANSPORT environment variable:

| Value | Description | Default | |-------|-------------|---------| | stdio | Standard I/O (CLI/IDE integration) | Yes | | http | Streamable HTTP on MCP_PORT (default 3101) | No | | sse | Server-Sent Events on MCP_PORT (default 3101) | No |

Usage Examples

Verify Age

Use the verify_age tool with birth_year=1990, birth_month=6, birth_day=15

Check State Compliance

Use the check_state tool with state=TX, product_type=flower

Generate Age Gate for a Website

Use the age_gate_snippet tool with business_name="My Hemp Shop", state=TX, license_number="DSHS #690"

Compliance

• Fail-closed: if verification fails or data is invalid, access is denied
• Conservative age calculation: if birth month/day are omitted, assumes birthday has not occurred yet this year
• State-specific minimums: most states require 21+, configurable per jurisdiction
• COA requirements and smokable bans tracked per state

Source

Built by Reggie & Dro LLC. Compliance data from the CRAFT framework.

License

MIT