Savvyscratch

io.github.myque08Published by GitHub account myque08v1.0.1Updated Oct 24, 2026

MCP server for Savvy Scratch — scratch-off lottery game analysis powered by pro gambler methodology

VerifiedSTDIODesktop onlyFinanceData & Analytics

Overview

AI-generated overview

A local MCP server that lets an assistant register and sign in to a Savvy Scratch account and analyze scratch-off lottery games across 19 U.S. states.

What you can do
Create and manage an account: register, log in, log out, check subscription status and get a subscribe link. Browse coverage: list the 19 supported states. Look up games: list scratch-off games for a state and view detailed prize breakdowns for a game. Get recommendations: find the best games for a given state and budget, ranked by weighted score. Free accounts see only top-3 previews; full game lists and prize details require a subscription.
When to use it
Useful if you play U.S. scratch-off lottery games and want an assistant to compare games, check remaining prizes or suggest games for a budget in one of the covered states. Not relevant for other kinds of gambling or non-U.S. lotteries.
Requirements
Runs locally via npx from the npm package @savvyscratch/mcp-server, so Node.js is needed. No API keys or environment variables; an account is created and signed in through the tools, and the session lives in the AI session. A paid subscription ($5/month or $50/year) is needed for full game data and prize breakdowns.
Before you install
The assistant creates an account and signs in with an email and password through the tools, so credentials pass through the conversation. Subscribing costs money and is done through a link the server returns. The server is about gambling; recommendations are analysis, not guarantees. Account state is tied to the AI session, so it may need signing in again.

Installation

In SourceWeft

  1. Open Savvyscratch in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.

Other MCP clients

Follow the launch instructions in the repository.

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:

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

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

Other MCP-compatible clients

Any client that supports stdio MCP servers can run:

bash
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

bash
git clone https://github.com/myque08/savvymcp.gitcd savvymcpnpm installnpm run buildnode dist/index.js

Links

Source: README.md at commit 0251fbe

Tools

0
SourceWeft has not started this package in its sandbox yet, so its tools are not known.

Version history

1
  1. v1.0.1LatestSep 16, 2026

Score

40% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 days25 pts

    Keep the endpoint answering the MCP handshake; SourceWeft probes it every 30 days.

  • Auth declared10 pts

    Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.

  • Tools listed15 pts

    Answer tools/list without a credential, or ship a package that starts in a sandbox without one.

  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts

    Declare a license in the repository or the registry entry.