{
  "markdown": "# Savvy Scratch MCP Server\n\n[![npm version](https://img.shields.io/npm/v/@savvyscratch/mcp-server)](https://www.npmjs.com/package/@savvyscratch/mcp-server)\n\n## Install\n\n### Claude Desktop\n\nOpen your `claude_desktop_config.json`:\n- **macOS:** `~/Library/Application Support/Claude/claude_desktop_config.json`\n- **Windows:** `%APPDATA%\\Claude\\claude_desktop_config.json`\n\nAdd the Savvy Scratch server:\n\n```json\n{\n  \"mcpServers\": {\n    \"savvyscratch\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@savvyscratch/mcp-server\"]\n    }\n  }\n}\n```\n\nRestart Claude Desktop. You're done.\n\n### Claude Code\n\nAdd to your project's `.mcp.json` (or run `claude mcp add`):\n\n```json\n{\n  \"mcpServers\": {\n    \"savvyscratch\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@savvyscratch/mcp-server\"]\n    }\n  }\n}\n```\n\n### Other MCP-compatible clients\n\nAny client that supports stdio MCP servers can run:\n\n```bash\nnpx -y @savvyscratch/mcp-server\n```\n\n## What is this?\n\nAn MCP (Model Context Protocol) server that gives AI assistants access to [Savvy Scratch](https://www.savvyscratch.com) — pro-gambler-grade analysis of scratch-off lottery games across 19 U.S. states.\n\nRegister, sign in, browse live game data, and subscribe — all through natural conversation with your AI. **Zero configuration required.**\n\n## First-time setup (through your AI)\n\nOnce installed, just talk to your AI:\n\n1. **\"Register a Savvy Scratch account for me\"** → AI uses the `register` tool\n2. **\"What scratch-off games should I play in Florida?\"** → AI uses `login` + `get_games`\n3. **\"Subscribe me to Savvy Scratch\"** → AI uses `get_subscribe_link`\n\nNo API keys. No env vars. Your account lives in your AI session.\n\n## Tools\n\n### Auth & Account\n| Tool | Description |\n|------|-------------|\n| `register` | Create a new Savvy Scratch account |\n| `login` | Sign in with email and password |\n| `logout` | Sign out |\n| `check_subscription` | View subscription status and plan details |\n| `get_subscribe_link` | Get a link to subscribe |\n\n### Game Analysis\n| Tool | Description | Free | Subscriber |\n|------|-------------|------|------------|\n| `list_states` | List all 19 covered states | Full | Full |\n| `get_games` | Get scratch-off games for a state | Top 3 | All games |\n| `game_details` | Detailed prize breakdown for a game | Locked | Full |\n| `best_games` | Best games for a budget and state | Top 3 | All matches |\n\n## Pricing\n\nFree accounts see top-3 previews in every state. A Savvy Scratch subscription ($5/mo or $50/yr) unlocks:\n\n- All games in all 19 states\n- Detailed prize-tier breakdowns with live remaining prizes\n- Budget-optimized recommendations ranked by weighted score\n- Pro gambler methodology applied to every game\n\n## Example Conversation\n\n```\nYou: What scratch-off games should I play in Florida?\n\nAI: [calls login, then get_games with state=fl]\n    Shows top 3 games with scores and odds...\n    \"Subscribe to see all 100 games. Use get_subscribe_link to get started.\"\n\nYou: I have $10 to spend in Georgia, what's best?\n\nAI: [calls best_games with state=ga, budget=10]\n    Shows top-rated games at $10 or under ranked by weighted score\n\nYou: Show me the prize breakdown for Atlanta Falcons\n\nAI: [calls game_details with state=ga, game_name=\"Atlanta Falcons\"]\n    Full prize tier breakdown with remaining prizes and adjusted odds\n```\n\n## Build from source\n\n```bash\ngit clone https://github.com/myque08/savvymcp.git\ncd savvymcp\nnpm install\nnpm run build\nnode dist/index.js\n```\n\n## Links\n\n- **npm package:** https://www.npmjs.com/package/@savvyscratch/mcp-server\n- **Website:** https://www.savvyscratch.com\n- **GitHub:** https://github.com/myque08/savvymcp\n- **Report issues:** https://github.com/myque08/savvymcp/issues\n",
  "bytes": 3697,
  "sha": "72515ede8e93a1b25498f20c2e79c3ef9ef37bd4864df26278133da7f374473c",
  "repo_slug": "myque08/savvymcp",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_myque08_savvyscratch_6090f54d/readme"
}