mcpField
S
savvyscratch

savvyscratch

Local
github.com/myque08Games & Entertainment0Updated 29w ago
Repository

About savvyscratch

savvyscratch is an MCP server that lets AI assistants access scratch-off lottery data and analysis for 19 U.S. states through natural language. It also supports account registration, subscription management, and budget-based game selection.

Key features

  1. 01Account registration, login, and subscriptions
  2. 02Browse scratch-off games by state
  3. 03View detailed game prize breakdowns
  4. 04Find games by budget
  5. 05Free previews and subscriber access

Use cases

  1. 01Query scratch-off games in a state
  2. 02Compare games within a budget
  3. 03Create an account or subscribe through an AI assistant

MCP support

It provides account and game-analysis tools to compatible clients as a stdio MCP server.

Configuration

Local server config is the same for every client. Copy it into your client’s MCP config file.

mcp.json · Universal config
{
  "mcpServers": {
    "myque08-savvyscratch": {
      "command": "npx",
      "args": [
        "-y",
        "@savvyscratch/mcp-server"
      ]
    }
  }
}
Run commandnpx -y @savvyscratch/mcp-server

Local servers need a runtime on your machine (e.g. Node.js 18+). Config file locations differ by client; see your client’s docs.

Packages
npm@savvyscratch/mcp-server1.0.1

Tools

9

Saved tool list · updated 2w ago

ParameterTypeRequiredDescription
emailstringYesYour email address
passwordstringYesChoose a password (minimum 6 characters)

Details

From the project README

Savvy Scratch MCP Server

npm version

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:

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

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

Any client that supports stdio MCP servers can run:

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:

  1. "Register a Savvy Scratch account for me" → AI uses the register tool
  2. "What scratch-off games should I play in Florida?" → AI uses login + get_games
  3. "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
ToolDescription
registerCreate a new Savvy Scratch account
loginSign in with email and password
logoutSign out
check_subscriptionView subscription status and plan details
get_subscribe_linkGet a link to subscribe
Game Analysis
ToolDescriptionFreeSubscriber
list_statesList all 19 covered statesFullFull
get_gamesGet scratch-off games for a stateTop 3All games
game_detailsDetailed prize breakdown for a gameLockedFull
best_gamesBest games for a budget and stateTop 3All 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

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

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

Links

Comments

Markdown supported

New to MCP?

From what the protocol is to installing your first server, these answers cover most first questions.

An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.