Savvy Scratch MCP Server

Install

Claude Desktop

Open your claude_desktop_config.json:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json

Add the Savvy Scratch server:

config.json

{
  "mcpServers": {
    "savvyscratch": {
      "command": "npx",
      "args": ["-y", "@savvyscratch/mcp-server"]
    }
  }
}

Restart Claude Desktop. You're done.

Claude Code

Add to your project's .mcp.json (or run claude mcp add):

config.json

{
  "mcpServers": {
    "savvyscratch": {
      "command": "npx",
      "args": ["-y", "@savvyscratch/mcp-server"]
    }
  }
}

Other MCP-compatible clients

Any client that supports stdio MCP servers can run:

Terminal

npx -y @savvyscratch/mcp-server

What is this?

An MCP (Model Context Protocol) server that gives AI assistants access to Savvy Scratch — pro-gambler-grade analysis of scratch-off lottery games across 19 U.S. states.

Register, sign in, browse live game data, and subscribe — all through natural conversation with your AI. Zero configuration required.

First-time setup (through your AI)

Once installed, just talk to your AI:

"Register a Savvy Scratch account for me" → AI uses the register tool
"What scratch-off games should I play in Florida?" → AI uses login + get_games
"Subscribe me to Savvy Scratch" → AI uses get_subscribe_link

No API keys. No env vars. Your account lives in your AI session.

Tools

Auth & Account

Tool	Description
`register`	Create a new Savvy Scratch account
`login`	Sign in with email and password
`logout`	Sign out
`check_subscription`	View subscription status and plan details
`get_subscribe_link`	Get a link to subscribe

Game Analysis

Tool	Description	Free	Subscriber
`list_states`	List all 19 covered states	Full	Full
`get_games`	Get scratch-off games for a state	Top 3	All games
`game_details`	Detailed prize breakdown for a game	Locked	Full
`best_games`	Best games for a budget and state	Top 3	All matches

Pricing

Free accounts see top-3 previews in every state. A Savvy Scratch subscription ($5/mo or $50/yr) unlocks:

All games in all 19 states
Detailed prize-tier breakdowns with live remaining prizes
Budget-optimized recommendations ranked by weighted score
Pro gambler methodology applied to every game

Example Conversation

Code

You: What scratch-off games should I play in Florida?

AI: [calls login, then get_games with state=fl]
    Shows top 3 games with scores and odds...
    "Subscribe to see all 100 games. Use get_subscribe_link to get started."

You: I have $10 to spend in Georgia, what's best?

AI: [calls best_games with state=ga, budget=10]
    Shows top-rated games at $10 or under ranked by weighted score

You: Show me the prize breakdown for Atlanta Falcons

AI: [calls game_details with state=ga, game_name="Atlanta Falcons"]
    Full prize tier breakdown with remaining prizes and adjusted odds

Build from source

bash

git clone https://github.com/myque08/savvymcp.git
cd savvymcp
npm install
npm run build
node dist/index.js

Savvyscratch README