fpl-intelligence 0.2.0__tar.gz

fpl_intelligence-0.2.0/.claude/commands/engineer.md

@@ -0,0 +1,30 @@
+---
+description: Software engineer agent — implements features, writes code, runs tests
+---
+
+You are the Software Engineer for x402 FPL Intelligence. You are part of a team of agents working together to build and grow this product.
+
+## Your Role
+You implement features, fix bugs, write tests, and ship code. You are hands-on — you read code, write code, run tests, and verify everything works before marking done.
+
+## Your Project
+This is an MCP server + HTTP API for Fantasy Premier League intelligence. The codebase is at ~/Projects/x402-fpl-api.
+
+Key files:
+- `mcp_server.py` — MCP server with 7 tools for Claude Desktop
+- `app/main.py` — FastAPI HTTP server with x402 payment middleware
+- `app/x402.py` — Payment verification (USDC on Base via HTTP 402)
+- `app/fpl_client.py` — FPL API wrapper with caching
+- `app/algorithms/` — Captain pick, differentials, fixtures, prices, transfers, live points
+- `app/config.py` — Settings and endpoint pricing
+- `tests/` — Test suite
+
+## How You Work
+1. Read the relevant code before making changes
+2. Make focused, minimal changes — don't over-engineer
+3. Run tests after every change: `cd ~/Projects/x402-fpl-api && source .venv/bin/activate && pytest tests/ -v`
+4. If you add a new feature, add tests for it
+5. Keep the MCP server and HTTP API in sync — new algorithms should be exposed in both
+
+## Your Task
+$ARGUMENTS

fpl_intelligence-0.2.0/.claude/commands/fpl-researcher.md

@@ -0,0 +1,31 @@
+---
+description: FPL researcher agent — researches FPL strategy, data, and trends online
+---
+
+You are the FPL Researcher for x402 FPL Intelligence. You are part of a team of agents working together to build and grow this product.
+
+## Your Role
+You research Fantasy Premier League strategy, data sources, community trends, and competitive landscape. You find information that improves our algorithms and product decisions.
+
+## What You Research
+1. **FPL strategy** — What captaincy strategies work best? What transfer patterns do top managers use? What metrics correlate most with FPL points?
+2. **Algorithm improvements** — Are our scoring weights (form ×2.0, PPG ×1.0, etc.) optimal? What other models exist? What do top FPL content creators recommend?
+3. **Data sources** — Are there additional free FPL data sources beyond the official API? Community datasets? xG providers?
+4. **Community trends** — What are FPL Twitter/Reddit talking about? What tools do managers wish they had? What pain points exist?
+5. **Competitive analysis** — What other FPL tools, bots, and APIs exist? What do they charge? What features do they have that we don't?
+
+## How You Work
+1. Search the web for current FPL information
+2. Focus on actionable findings — things we can implement or use to improve our algorithms
+3. Cite your sources
+4. Distinguish between facts (data) and opinions (strategy advice)
+5. Always relate findings back to how they affect our product
+
+## Current Algorithms to Improve
+- Captain pick: form ×2.0 + PPG ×1.0 + home_bonus 1.5 - FDR ×1.0 + ICT ×0.01 + bonus_pg ×0.5 - injury penalty
+- Differentials: form ×3.0 + PPG ×1.0 - FDR ×0.5 + ICT ×0.01 - ownership ×0.1
+- Transfer value: form ×2.0 + PPG ×1.0 - FDR ×1.0 + home 0.5
+- Price predictions: net transfer volume vs threshold estimates
+
+## Your Task
+$ARGUMENTS

fpl_intelligence-0.2.0/.claude/commands/marketing.md

@@ -0,0 +1,35 @@
+---
+description: Marketing agent — handles distribution, listings, content, and growth
+---
+
+You are the Marketing Lead for x402 FPL Intelligence. You are part of a team of agents working together to build and grow this product.
+
+## Your Role
+You handle distribution, discovery, and growth. You get this MCP server in front of as many FPL managers and AI agent developers as possible.
+
+## Our Product
+- **What:** An MCP server giving Claude Desktop users personalized FPL intelligence (captain picks, transfers, differentials, fixtures, price predictions, live points)
+- **Where:** GitHub repo at https://github.com/dohyung1/x402-fpl-api
+- **Who:** FPL managers who use Claude, AI agent developers building FPL tools
+- **USP:** Only FPL MCP server. Auto-detects your team status. 7 tools covering every FPL decision.
+
+## Your Channels
+1. **MCP directories** — Glama (glama.ai/mcp), mcp.so, Smithery (smithery.ai), official MCP registry, awesome-mcp-servers GitHub repo
+2. **FPL community** — Reddit r/FantasyPL, FPL Twitter, FPL Discord servers, FPL content creators
+3. **Developer community** — Hacker News, Reddit r/ClaudeAI, Reddit r/MCP, Dev.to, Twitter
+4. **SEO** — GitHub repo description, tags, README optimization
+
+## How You Work
+1. Research each channel for submission requirements and best practices
+2. Draft listings, posts, and content — ready to publish
+3. Tailor messaging to the audience (FPL managers vs developers vs AI enthusiasts)
+4. Track what's been submitted and what hasn't
+5. Propose a content calendar if ongoing posting makes sense
+
+## Key Messages
+- "The only FPL MCP server — get AI-powered captain picks, transfer advice, and more inside Claude"
+- "Just give Claude your FPL team ID and it auto-detects your bank, free transfers, and chips"
+- "7 tools covering every FPL decision: captain, transfers, differentials, fixtures, prices, live points"
+
+## Your Task
+$ARGUMENTS

fpl_intelligence-0.2.0/.claude/commands/monetizer.md

@@ -0,0 +1,30 @@
+---
+description: Monetizer agent — researches and proposes monetization strategies
+---
+
+You are the Monetizer for x402 FPL Intelligence. You are part of a team of agents working together to build and grow this product.
+
+## Your Role
+You research monetization strategies for MCP servers and AI agent services. You find real examples of what's working, propose pricing models, and identify revenue opportunities.
+
+## Our Current Product
+- An MCP server with 7 FPL intelligence tools (free, runs locally via Claude Desktop)
+- An HTTP API with x402 micropayments (USDC on Base, $0.001-$0.005 per query) — built but not yet deployed publicly
+- Target customers: AI agents, FPL chatbot developers, FPL app builders
+
+## What You Research
+1. **MCP monetization** — How are other MCP servers making money? Are any charging? What models exist (freemium, premium tools, hosted vs self-hosted)?
+2. **Agent economy** — How are AI agent services being monetized in 2025-2026? What payment protocols exist beyond x402?
+3. **FPL market** — How big is the FPL audience? What do existing FPL tools charge? What's the willingness to pay?
+4. **Pricing strategy** — What should our free tier include? What's worth charging for? Per-query vs subscription vs one-time?
+5. **Revenue channels** — Sponsorships, affiliate deals with FPL content creators, premium data partnerships, white-labeling?
+
+## How You Work
+1. Search the web for current market data and examples
+2. Focus on actionable strategies with estimated revenue potential
+3. Propose concrete pricing with reasoning
+4. Consider our constraints: solo founder, iOS engineer background, minimal infrastructure
+5. Prioritize by effort vs reward — what's the fastest path to first revenue?
+
+## Your Task
+$ARGUMENTS

fpl_intelligence-0.2.0/.claude/commands/reviewer.md

@@ -0,0 +1,28 @@
+---
+description: Code reviewer agent — reviews code for quality, bugs, security, and performance
+---
+
+You are the Code Reviewer for x402 FPL Intelligence. You are part of a team of agents working together to build and grow this product.
+
+## Your Role
+You review code for bugs, security issues, performance problems, and maintainability. You are thorough but practical — flag real problems, not style nitpicks.
+
+## Your Project
+This is an MCP server + HTTP API for Fantasy Premier League intelligence. The codebase is at ~/Projects/x402-fpl-api.
+
+## What You Review
+1. **Bugs** — Logic errors, edge cases, unhandled exceptions
+2. **Security** — Injection risks, data leaks, unsafe inputs. The x402 payment flow is security-critical (replay attacks, insufficient payment, fake tx hashes)
+3. **Performance** — Unnecessary API calls, missing caching, N+1 queries against the FPL API
+4. **Data correctness** — FPL algorithm logic (captain scoring weights, fixture difficulty ratings, transfer value calculations)
+5. **API contract** — MCP tool descriptions must be clear and accurate for AI agents to use correctly
+
+## How You Work
+1. Read all relevant files before giving feedback
+2. For each issue, cite the file and line number
+3. Rate severity: CRITICAL (must fix), WARNING (should fix), SUGGESTION (nice to have)
+4. If you find no issues, say so — don't invent problems
+5. After reviewing, summarize: what's good, what needs fixing, overall assessment
+
+## Your Task
+$ARGUMENTS

fpl_intelligence-0.2.0/.env.example

@@ -0,0 +1,22 @@
+# x402 FPL Intelligence API — Environment Variables
+# Copy this to .env and fill in your values
+
+# Our wallet address that receives USDC payments
+PAYMENT_WALLET_ADDRESS=0xYourWalletAddressHere
+
+# Base network RPC endpoint
+# Testnet (Base Sepolia): https://sepolia.base.org
+# Mainnet (Base): https://mainnet.base.org
+BASE_RPC_URL=https://sepolia.base.org
+
+# USDC contract address
+# Base Sepolia testnet: 0x036CbD53842c5426634e7929541eC2318f3dCF7e
+# Base mainnet:         0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913
+USDC_CONTRACT_ADDRESS=0x036CbD53842c5426634e7929541eC2318f3dCF7e
+
+# Number of block confirmations required before accepting payment
+REQUIRED_CONFIRMATIONS=1
+
+# Service metadata
+SERVICE_NAME=x402-fpl-api
+SERVICE_DESCRIPTION=AI-agent-native Fantasy Premier League intelligence

fpl_intelligence-0.2.0/.gitignore

@@ -0,0 +1,22 @@
+# Python-generated files
+__pycache__/
+*.py[oc]
+build/
+dist/
+wheels/
+*.egg-info
+
+# Virtual environments
+.venv
+
+# Environment variables (contains wallet address)
+.env
+
+# OS
+.DS_Store
+
+# Test cache
+.pytest_cache/
+
+# SQLite payment database
+data/

fpl_intelligence-0.2.0/.python-version

@@ -0,0 +1 @@
+3.12

fpl_intelligence-0.2.0/CLAUDE.md

@@ -0,0 +1,99 @@
+# x402 FPL Intelligence API
+
+## Project Vision
+An AI-agent-native Fantasy Premier League (FPL) intelligence API. Agents pay per-query using the x402 (HTTP 402) protocol — no API keys, no subscriptions, no signup. We turn free public FPL data into actionable recommendations that AI agents can consume instantly.
+
+The long-term play: FPL is the proving ground. Once x402 works here, we expand to other fantasy sports and eventually the client/server SDK becomes the real product — "Stripe for agent commerce."
+
+## Tech Stack
+- **Server:** Python + FastAPI
+- **Payment verification:** web3.py (USDC on Base L2)
+- **Data source:** FPL public API (https://fantasy.premierleague.com/api/) — free, real-time, no auth
+- **Hosting:** Single VPS or serverless (low compute)
+- **Agent wallet:** Coinbase CDP SDK or standard EOA
+
+## The x402 Payment Flow
+Every paid endpoint follows this pattern:
+1. Agent sends request (no token, no auth)
+2. Server responds **402** + JSON body: `{ price, wallet_address, service_name }`
+3. Agent pays on-chain (USDC on Base L2, sub-penny fees, <1s settlement)
+4. Agent retries with `X-Payment` header containing the tx hash
+5. Server verifies tx on-chain → delivers response
+
+Two HTTP requests per paid call. Zero auth infrastructure.
+
+## Endpoints & Pricing
+
+| Endpoint | Price | Description |
+|---|---|---|
+| `GET /api/fpl/captain-pick` | $0.002 | Top 5 captain recommendations with scoring breakdown |
+| `GET /api/fpl/transfer-suggest` | $0.005 | Transfer in/out recommendations for a given team |
+| `GET /api/fpl/differentials` | $0.001 | Underowned players outperforming their ownership |
+| `GET /api/fpl/fixture-outlook` | $0.001 | Teams ranked by upcoming fixture difficulty |
+| `GET /api/fpl/price-predictions` | $0.002 | Players likely to rise or fall in price tonight |
+| `GET /api/fpl/live-points` | $0.001 | Live score, projected bonus, auto-sub scenarios |
+
+## FPL Data Sources (all free, public)
+- `GET /bootstrap-static/` — All players, teams, gameweeks, scoring rules
+- `GET /fixtures/` — All 380 fixtures with FDR ratings
+- `GET /event/{gw}/live/` — Real-time points during matches
+- `GET /element-summary/{player_id}/` — Per-player fixture history
+- `GET /entry/{team_id}/event/{gw}/picks/` — Team's picks for a gameweek
+- `GET /entry/{team_id}/history/` — Season history and chips used
+
+## Captain Score Algorithm
+```
+captain_score =
+    form × 2.0
+  + points_per_game × 1.0
+  + home_bonus (1.5 if home, else 0)
+  - fixture_difficulty × 1.0      (FDR 1–5)
+  + ict_index × 0.01
+  + bonus_per_game × 0.5
+  - injury_penalty (0 if fit, -10 if doubtful/injured)
+```
+Weights are tuned over time against actual GW results — this tuning is our core IP.
+
+## Build Order
+- **Phase 1:** Real x402 payment flow with USDC on Base testnet
+- **Phase 2:** Captain pick endpoint (easiest, highest value)
+- **Phase 3:** Differential finder (proves multi-endpoint model)
+- **Phase 4:** Extract client SDK as open source package (distribution)
+- **Phase 5:** Remaining endpoints (transfers, fixtures, live, prices)
+- **Phase 6:** Service directory listing for agent discovery
+- **Phase 7:** Expand to NFL, NBA, Champions League
+
+## Project Structure (target)
+```
+x402-fpl-api/
+├── CLAUDE.md
+├── README.md
+├── pyproject.toml
+├── app/
+│   ├── main.py            # FastAPI app, x402 middleware
+│   ├── x402.py            # Payment verification logic
+│   ├── fpl_client.py      # FPL API wrapper with caching
+│   ├── algorithms/
+│   │   ├── captain.py     # Captain pick scoring
+│   │   ├── differentials.py
+│   │   ├── fixtures.py
+│   │   ├── transfers.py
+│   │   ├── prices.py
+│   │   └── live.py
+│   └── models.py          # Pydantic response schemas
+├── tests/
+└── scripts/
+    └── seed_testnet.py    # Fund test wallet on Base Sepolia
+```
+
+## Revenue Model
+Pay-per-query in USDC on Base L2. No subscriptions, no API keys, no billing infrastructure.
+
+Example at scale: 50 FPL agent apps × 1,000 users × 5 queries/week × $0.002 avg = **~$19,000/season**
+
+## Key Principles
+- **Agent-first:** Every response is JSON optimized for machine consumption, not humans
+- **Zero friction:** No signup. No API key. Agent discovers, pays, gets data
+- **Intelligence over data:** Return recommendations with reasoning, not raw stats
+- **Minimize infra:** No frontend, no user management, no auth system
+- **Start narrow:** Nail FPL before expanding to other sports

fpl_intelligence-0.2.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 dohyung1
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

fpl_intelligence-0.2.0/MARKETING_DRAFTS.md

@@ -0,0 +1,76 @@
+# Marketing Drafts — Ready to Submit
+
+## Glama (glama.ai/mcp)
+Submit GitHub URL: https://github.com/dohyung1/x402-fpl-api via "Add Server" button.
+Glama auto-indexes from the repo.
+
+---
+
+## mcp.so/submit
+- **Type:** MCP Server
+- **Name:** FPL Intelligence
+- **URL:** https://github.com/dohyung1/x402-fpl-api
+
+---
+
+## awesome-mcp-servers PR
+
+**Line to add under "Sports" category:**
+```
+- [dohyung1/x402-fpl-api](https://github.com/dohyung1/x402-fpl-api) 🐍 🏠 - Personalized Fantasy Premier League intelligence — captain picks, transfer suggestions, differentials, fixture outlook, price predictions, live points, and a full manager hub that auto-detects bank balance, free transfers, and chips.
+```
+
+---
+
+## Reddit r/FantasyPL
+
+**Title:** I built an AI assistant that analyzes your FPL team and gives personalized recommendations — free and open source
+
+Been playing FPL for years and got tired of manually cross-referencing form, fixtures, ownership, and price changes every week. So I built a tool that does it all at once.
+
+It connects to Claude Desktop (Anthropic's AI app) and gives you 7 tools you can ask in plain English:
+
+- **Captain pick** — scores your options by form, PPG, home advantage, fixture difficulty, ICT index, and bonus rate. Gives you the top 5 with reasoning.
+- **Transfer suggestions** — looks at your actual squad, identifies your weakest starters, and suggests replacements within your budget.
+- **Differentials** — finds players under 10% ownership who are returning well. Good for climbing mini-leagues.
+- **Fixture outlook** — ranks all 20 teams by upcoming FDR and surfaces the best players to target from favorable-fixture teams.
+- **Price predictions** — flags players likely to rise or fall tonight based on net transfer volume.
+- **Live points** — live scores, projected bonus, auto-sub scenarios during a gameweek.
+- **Manager hub** — the big one. Give it your team ID and it auto-detects your bank, free transfers, and chips, then runs everything above in one go.
+
+All data comes from the official FPL API in real time. No scraping, no dodgy sources.
+
+You just tell Claude "Analyze FPL team 12345 and give me your full recommendation" and it pulls your actual squad, runs the numbers, and gives you a full briefing. Bank balance, free transfers, chips — all auto-detected. You don't need to enter anything manually.
+
+It's open source and free: https://github.com/dohyung1/x402-fpl-api
+
+You need Claude Desktop installed (free tier works). Setup takes about 2 minutes — clone the repo, add one config block, restart Claude.
+
+Happy to answer questions. Would love feedback from other FPL managers on what analysis would be most useful to add.
+
+---
+
+## Reddit r/ClaudeAI
+
+**Title:** Built an MCP server that turns Claude Desktop into a Fantasy Premier League analyst
+
+Sharing an MCP server I built that gives Claude real-time FPL (Fantasy Premier League) intelligence. It exposes 7 tools that Claude can call to analyze any manager's team using live data from the official Premier League API.
+
+**What it does:**
+- Captain pick scoring (form, fixtures, ICT, bonus rate weighted algorithm)
+- Transfer suggestions personalized to your squad and budget
+- Differential finder (low-ownership outperformers)
+- Fixture difficulty rankings with player targets
+- Price change predictions from transfer volume
+- Live gameweek points with projected bonus
+- A "manager hub" tool that auto-detects bank balance, free transfers, and chips from the FPL API, then runs the full analysis in one call
+
+**Tech:**
+- Python + FastMCP
+- All data from the public FPL API (no auth needed, no rate limits)
+- Algorithms score players using a weighted composite of form, PPG, home advantage, FDR, ICT index, and bonus rate
+- The manager hub tool runs all sub-analyses in parallel using asyncio.gather
+
+Repo: https://github.com/dohyung1/x402-fpl-api
+
+Setup is just clone + add to `claude_desktop_config.json`. Uses `uv` for dependency management.

fpl_intelligence-0.2.0/PKG-INFO

@@ -0,0 +1,80 @@
+Metadata-Version: 2.4
+Name: fpl-intelligence
+Version: 0.2.0
+Summary: AI-powered Fantasy Premier League MCP server — captain picks, transfer suggestions, player comparison, chip strategy, and more
+Project-URL: Homepage, https://github.com/dohyung1/x402-fpl-api
+Project-URL: Repository, https://github.com/dohyung1/x402-fpl-api
+Project-URL: Issues, https://github.com/dohyung1/x402-fpl-api/issues
+Author: dohyung1
+License: MIT
+License-File: LICENSE
+Keywords: ai,claude,fantasy-football,fantasy-premier-league,fpl,mcp
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Games/Entertainment
+Requires-Python: >=3.12
+Requires-Dist: fastapi>=0.128.8
+Requires-Dist: httpx>=0.28.1
+Requires-Dist: mcp[cli]>=1.26.0
+Requires-Dist: pydantic-settings>=2.11.0
+Requires-Dist: python-dotenv>=1.2.1
+Requires-Dist: uvicorn[standard]>=0.39.0
+Requires-Dist: web3>=7.14.1
+Description-Content-Type: text/markdown
+
+# FPL Intelligence — MCP Server
+
+AI-powered Fantasy Premier League assistant for Claude Desktop. Get personalized captain picks, transfer suggestions, differentials, fixture analysis, price predictions, and live points — all from real FPL data.
+
+## Setup
+
+```bash
+git clone https://github.com/dohyung1/x402-fpl-api.git
+cd x402-fpl-api
+uv sync
+```
+
+Add to your Claude Desktop config (`~/Library/Application Support/Claude/claude_desktop_config.json`):
+
+```json
+{
+  "mcpServers": {
+    "fpl": {
+      "command": "uv",
+      "args": ["run", "--directory", "/path/to/x402-fpl-api", "mcp_server.py"]
+    }
+  }
+}
+```
+
+Restart Claude Desktop and ask:
+
+> "Analyze FPL team YOUR_TEAM_ID and give me your full recommendation."
+
+Bank balance, free transfers, and chips are all auto-detected — just provide your team ID.
+
+## Find Your FPL Team ID
+
+Go to the [FPL website](https://fantasy.premierleague.com), click "Points", and look at the URL:
+
+```
+https://fantasy.premierleague.com/entry/YOUR_TEAM_ID/event/<gw>
+```
+
+## Available Tools
+
+| Tool | What it does |
+|---|---|
+| `fpl_manager_hub` | Full personalized analysis — captain, transfers, differentials, fixtures, price risks |
+| `captain_pick` | Top 5 captain recommendations scored by xG, form, fixtures, and ICT index |
+| `transfer_suggestions` | Transfer in/out recommendations based on your squad and budget |
+| `player_comparison` | Head-to-head compare 2-4 players (e.g. "Salah vs Palmer vs Saka") |
+| `is_hit_worth_it` | Should you take a -4 hit? Projects points over N gameweeks to decide |
+| `chip_strategy` | When to use your remaining chips — optimal GW for each based on fixtures |
+| `differential_finder` | Underowned players outperforming their ownership % |
+| `fixture_outlook` | Teams ranked by upcoming fixture difficulty + best players to target |
+| `price_predictions` | Players likely to rise or fall in price tonight |
+| `live_points` | Live score, projected bonus, and auto-sub scenarios |

fpl_intelligence-0.2.0/PLAN.md

@@ -0,0 +1,128 @@
+# FPL Intelligence — Execution Plan
+
+## Positioning
+"Intelligence, not data." We are the only FPL MCP server that returns scored recommendations with reasoning. Competitors (rishijatia, owen-lacey) return raw data.
+
+## Competitors
+| Competitor | Stars | Strength | Weakness |
+|---|---|---|---|
+| rishijatia/fantasy-pl-mcp | 69 | PyPI install, prompt templates, 11 tools | No captain scoring, no price predictions, no manager hub. Last updated Aug 2025 |
+| owen-lacey/fpl-mcp | 3 | 16 tools, Glama listed, npm | Pure data wrapper. Zero intelligence |
+
+## Our Edge
+- `fpl_manager_hub` — unique all-in-one analysis (no competitor has this)
+- Scored captain picks with reasoning
+- Price predictions
+- Live points with auto-sub scenarios
+- xG/xA-powered algorithms (v2, after engineer fix)
+
+---
+
+## Sprint 1: Harden & Ship (This Week)
+
+### Track A — Critical Fixes (Engineer Agent) — DONE ✅
+- [x] Review complete — 5 critical, 11 warnings found
+- [x] SQLite replay protection (replace in-memory set)
+- [x] Thread-safe tx hash checking (atomic INSERT OR IGNORE)
+- [x] Async verify_payment (asyncio.to_thread for Web3 calls)
+- [x] Fix Web3 connection caching (remove lru_cache)
+- [x] Double gameweek (DGW) support in fixture map
+- [x] Captain/transfer endpoints default to NEXT gameweek
+- [x] Refactor fpl_manager_hub to call existing algorithm functions
+- [x] Fix web_name collision (use element IDs)
+- [x] Upgrade captain algorithm with xG, xA, penalty data from FPL API
+- [x] Run tests (15/15 passing), commit, push
+
+### Track B — Distribution (Marketing Agent) — DONE
+- [x] GitHub topics added (mcp, fpl, fantasy-premier-league, etc.)
+- [x] GitHub description updated
+- [x] All directory listing drafts ready (MARKETING_DRAFTS.md)
+- [x] Reddit posts drafted (r/FantasyPL, r/ClaudeAI)
+- [x] Submit to awesome-mcp-servers PR (#3340)
+- [ ] Submit to Glama (manual — visit glama.ai/mcp/servers, click "Add Server")
+- [ ] Submit to mcp.so (manual — visit mcp.so/submit)
+- [ ] Post on Reddit (after first week of accuracy tracking)
+
+### Track C — Research — DONE
+- [x] FPL API has xG/xA/penalty/set piece data we weren't using
+- [x] Top competitor gaps identified
+- [x] Manager pain points mapped (captaincy, hit decisions, chip timing)
+- [x] Monetization model defined ($19.99/season freemium)
+
+---
+
+## Sprint 2: Compete & Monetize (Next Week)
+
+### Close Competitive Gaps
+- [ ] Publish to PyPI (`pip install fpl-intelligence`) — one-command install
+- [x] Add MCP prompt templates (5 prompts: analyze team, captain, differentials, transfers, price alerts)
+- [x] Captain weights v2.1 — backtest-tuned (PPG×3.0, form×2.5, FDR×2.0)
+- [x] Backtest script (`scripts/backtest.py`) — replay GWs, Haaland baseline, weight suggestions
+- [x] MIT LICENSE added
+- [ ] Add blank/double gameweek detection tool
+- [ ] Add player comparison tool
+- [ ] Add chip strategy advisor tool
+- [ ] Add "Is this hit worth it?" tool (unique, no competitor has this)
+
+### Distribution Push
+- [ ] Submit to Smithery
+- [ ] Post on r/FantasyPL with accuracy data
+- [ ] Post on r/ClaudeAI
+- [ ] Rebrand MCP as "FPL Intelligence" (drop x402 from public-facing name)
+
+### Revenue Setup
+- [ ] Set up LemonSqueezy for season pass ($19.99/season)
+- [ ] Define free vs paid tier split
+- [ ] Add API key gating for paid features
+- [ ] Deploy HTTP API to Railway/Fly.io
+
+---
+
+## Sprint 3: Grow (Weeks 3-4)
+
+### Product
+- [ ] Multi-gameweek transfer planning (score targets across next 3-5 GWs)
+- [ ] Integrate Understat for rolling per-match xG
+- [ ] Add usage metrics tracking (SQLite → PostHog)
+- [ ] Track captain pick accuracy weekly — publish as credibility metric
+
+### Growth
+- [ ] Weekly "AI captain picks" posts on r/FantasyPL
+- [ ] Reach out to FPL content creators (YouTube/Twitter)
+- [ ] Iterate on algorithms based on actual GW results
+- [ ] First 50 paying users → $1,000 revenue target
+
+---
+
+## Revenue Model
+
+### Free Tier (MCP, no auth)
+- Captain pick (top 3, no reasoning)
+- Differentials (top 5)
+- Fixture outlook (3 GWs)
+- Price predictions
+
+### Paid Tier — $19.99/season or $4.99/month
+- Full `fpl_manager_hub`
+- Transfer suggestions
+- Live points
+- Full captain picks with reasoning
+- Extended fixture outlook (10 GWs)
+- Accuracy dashboard
+
+### Projections
+| Scale | Users | Revenue/Season |
+|---|---|---|
+| Minimum | 50 | $1,000 |
+| Modest | 250 | $5,000 |
+| Good | 1,000 | $20,000 |
+| Strong PMF | 5,000 | $100,000 |
+
+---
+
+## Key Metrics to Track
+1. GitHub stars + clones
+2. MCP directory installs
+3. Captain pick accuracy vs community average
+4. Free → paid conversion rate (target 3-5%)
+5. Weekly active users (tool calls per GW)

fpl_intelligence-0.2.0/README.md

@@ -0,0 +1,53 @@
+# FPL Intelligence — MCP Server
+
+AI-powered Fantasy Premier League assistant for Claude Desktop. Get personalized captain picks, transfer suggestions, differentials, fixture analysis, price predictions, and live points — all from real FPL data.
+
+## Setup
+
+```bash
+git clone https://github.com/dohyung1/x402-fpl-api.git
+cd x402-fpl-api
+uv sync
+```
+
+Add to your Claude Desktop config (`~/Library/Application Support/Claude/claude_desktop_config.json`):
+
+```json
+{
+  "mcpServers": {
+    "fpl": {
+      "command": "uv",
+      "args": ["run", "--directory", "/path/to/x402-fpl-api", "mcp_server.py"]
+    }
+  }
+}
+```
+
+Restart Claude Desktop and ask:
+
+> "Analyze FPL team YOUR_TEAM_ID and give me your full recommendation."
+
+Bank balance, free transfers, and chips are all auto-detected — just provide your team ID.
+
+## Find Your FPL Team ID
+
+Go to the [FPL website](https://fantasy.premierleague.com), click "Points", and look at the URL:
+
+```
+https://fantasy.premierleague.com/entry/YOUR_TEAM_ID/event/<gw>
+```
+
+## Available Tools
+
+| Tool | What it does |
+|---|---|
+| `fpl_manager_hub` | Full personalized analysis — captain, transfers, differentials, fixtures, price risks |
+| `captain_pick` | Top 5 captain recommendations scored by xG, form, fixtures, and ICT index |
+| `transfer_suggestions` | Transfer in/out recommendations based on your squad and budget |
+| `player_comparison` | Head-to-head compare 2-4 players (e.g. "Salah vs Palmer vs Saka") |
+| `is_hit_worth_it` | Should you take a -4 hit? Projects points over N gameweeks to decide |
+| `chip_strategy` | When to use your remaining chips — optimal GW for each based on fixtures |
+| `differential_finder` | Underowned players outperforming their ownership % |
+| `fixture_outlook` | Teams ranked by upcoming fixture difficulty + best players to target |
+| `price_predictions` | Players likely to rise or fall in price tonight |
+| `live_points` | Live score, projected bonus, and auto-sub scenarios |