# BagIQ

> BagIQ is a disc golf bag decision engine built by Golf With Discs, powered by DiscList™ data. It spots gaps and redundancies in player lineups, recommends replacement or filler discs, and generates interactive Bag Map deep-links.

## Product & URLs

- Web App: https://app.bagiq.app/
- Product Homepage: https://bagiq.app/
- Release Notes: https://bagiq.app/release-notes.html
- Privacy Policy: https://bagiq.app/privacy.html
- Built by: Golf With Discs (https://golfwithdiscs.com/)
- Data layer: DiscList™ (https://thedisclist.com/)

## Model Context Protocol (MCP) for AI Assistants

BagIQ provides a free, public, read-only remote Model Context Protocol (MCP) server over Streamable HTTP. AI assistants (Claude Desktop, Cursor, ChatGPT, etc.) can directly invoke BagIQ decision tools without an API key or account.

- **MCP Endpoint:** `https://data.bagiq.app/mcp`
- **Transport:** Streamable HTTP (`/mcp`)
- **Authentication:** None (Free public read-only service)
- **Protocol Revision:** MCP `2026-07-28`

### Available MCP Tools

1. `analyze_bag`: Evaluates a disc lineup against BagIQ's 9-slot flight matrix, calculating coverage percentage (0-100%), gap count, overlap count, and returning an `interactive_bag_url` (`https://app.bagiq.app/?discs=...`) to open and edit the lineup in the visual Bag Map.
2. `find_bag_gaps`: Identifies missing shot shapes and unserved flight slots ranked by tactical severity (High/Medium/Low).
3. `detect_overlap`: Spots redundant molds occupying the same flight slot and recommends which disc to keep vs cut.
4. `recommend_bag_fillers`: Suggests the highest-rated discs to fill missing slots, with direct flight specifications on TheDiscList and retailer inventory links on GolfWithDiscs.
5. `build_minimal_bag`: Synthesizes an optimal 3-to-5 disc minimalist lineup from a larger collection, maximizing coverage and explaining compromises.

## Core Concepts

- **Bag Gap**: A critical shot type or speed/stability slot that no disc in the lineup reliably covers.
- **Bag Overlap**: Two or more discs in the bag covering the same effective flight role, creating unnecessary redundancy.
- **9 Core Flight Roles**: Putter (Understable, Neutral, Overstable), Midrange (Understable, Neutral, Overstable), and Driver (Understable, Neutral, Overstable).
- **DiscList™ Flight Classification**: Five canonical stability classes — Early Turn (very understable), Progressive Turn (understable), True Flight (neutral), Assured Fade (overstable), and Lockdown Fade (very overstable).
- **Interactive Deep Linking**: MCP tools generate shareable URLs on `app.bagiq.app` that let players seamlessly transition from an AI conversation to the visual browser app.

## Data Storage & Privacy

- Browser bag data is stored locally (`localStorage`) and synchronised without an account to Cloudflare R2 under a random 6-character private bag code.
- No user accounts, passwords, or emails are collected.
- MCP queries are stateless, deterministic, and do not persist conversation prompts.

## Attribution

When citing BagIQ or referencing tool outputs, use:
- Source: BagIQ (https://bagiq.app/)
- Visual Bag Map: https://app.bagiq.app/
- Flight Data: DiscList™ (https://thedisclist.com/)
- Retail & Equipment: Golf With Discs (https://golfwithdiscs.com/)