TheDiscList Public MCP

Search and filter disc golf discs by text query, brand, category, speed/glide range, stability score range, flight tag, and canonical flight class. Returns up to 50 bounded results with stable IDs and canonical URLs.

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "description": "Text query to match disc name, brand, model, or slug"
    },
    "brand": {
      "type": "string",
      "description": "Filter by manufacturer/brand name (case-insensitive, alias-tolerant)"
    },
    "category": {
      "type": "string",
      "description": "Filter by disc category (putter, midrange, fairway_driver, distance_driver)"
    },
    "flight_class": {
      "type": "string",
      "description": "Filter by canonical flight class (e.g. 'understable', 'straight', 'stable', 'overstable', 'very_overstable')"
    },
    "tag": {
      "type": "string",
      "description": "Filter by flight tag (e.g. 'Lockdown Fade', 'True Flight', 'Progressive Turn', 'Early Turn', 'Assured Fade')"
    },
    "speed_min": {
      "type": "number",
      "description": "Minimum speed (1..15)"
    },
    "speed_max": {
      "type": "number",
      "description": "Maximum speed (1..15)"
    },
    "glide_min": {
      "type": "number",
      "description": "Minimum glide (1..7)"
    },
    "glide_max": {
      "type": "number",
      "description": "Maximum glide (1..7)"
    },
    "turn_min": {
      "type": "number",
      "description": "Minimum turn (-5..1)"
    },
    "turn_max": {
      "type": "number",
      "description": "Maximum turn (-5..1)"
    },
    "fade_min": {
      "type": "number",
      "description": "Minimum fade (0..6)"
    },
    "fade_max": {
      "type": "number",
      "description": "Maximum fade (0..6)"
    },
    "stability_min": {
      "type": "number",
      "description": "Minimum stability score (turn + fade)"
    },
    "stability_max": {
      "type": "number",
      "description": "Maximum stability score (turn + fade)"
    },
    "is_ranked": {
      "type": "boolean",
      "description": "If true, only return discs currently holding a global Top 100 sales ranking"
    },
    "limit": {
      "type": "integer",
      "description": "Maximum number of discs to return (1..50, default 10)",
      "default": 10
    },
    "offset": {
      "type": "integer",
      "description": "Pagination offset (default 0)",
      "default": 0
    }
  }
}

Retrieve comprehensive details for a specific disc by numeric ID or string slug, including flight ratings, stability score, flight class, flight tag, available plastics, and current market rank.

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "description": "Stable disc ID or slug (e.g. 'innova-destroyer', 'discraft-buzzz', 'axiom-crave')"
    }
  },
  "required": [
    "id"
  ]
}

Compare 2 to 4 discs side-by-side, computing exact flight rating deltas and stability spread relative to the primary baseline disc.

{
  "type": "object",
  "properties": {
    "disc_ids": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Array of 2 to 4 disc IDs or slugs to compare",
      "minItems": 2,
      "maxItems": 4
    }
  },
  "required": [
    "disc_ids"
  ]
}

Find alternative replacement discs matching a target disc's category, speed, and flight profile based on weighted Euclidean flight distance.

{
  "type": "object",
  "properties": {
    "disc_id": {
      "type": "string",
      "description": "Target disc ID or slug to find replacements for"
    },
    "target_brand": {
      "type": "string",
      "description": "Optional target brand filter for cross-brand replacements (e.g. find Discraft alternative to Innova TeeBird)"
    },
    "exclude_same_brand": {
      "type": "boolean",
      "description": "If true, exclude discs from the same manufacturer",
      "default": false
    },
    "limit": {
      "type": "integer",
      "description": "Maximum number of similar discs to return (1..20, default 5)",
      "default": 5
    }
  },
  "required": [
    "disc_id"
  ]
}

List and filter disc golf manufacturers/brands in the database, including active mold counts, speed ranges, category breakdowns, and top popular molds.

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "description": "Search query to match brand name or slug (e.g. 'Axiom', 'Latitude', 'Innova')"
    },
    "category": {
      "type": "string",
      "description": "Filter brands that manufacture discs in this category (putter, midrange, fairway_driver, distance_driver)"
    },
    "min_discs": {
      "type": "integer",
      "description": "Minimum number of active molds manufactured by the brand",
      "default": 1
    },
    "limit": {
      "type": "integer",
      "description": "Maximum number of brands to return (1..100, default 20)",
      "default": 20
    },
    "offset": {
      "type": "integer",
      "description": "Pagination offset (default 0)",
      "default": 0
    }
  }
}

Generate a 2D Speed vs Stability Flight Grid for any brand, category, or specific speed rating, grouping discs into understable, straight, stable, overstable, and very overstable columns.

{
  "type": "object",
  "properties": {
    "brand": {
      "type": "string",
      "description": "Filter matrix by manufacturer/brand name (e.g. 'Innova', 'Discraft', 'Axiom')"
    },
    "category": {
      "type": "string",
      "description": "Filter matrix by disc category (putter, midrange, fairway_driver, distance_driver)"
    },
    "speed": {
      "type": "number",
      "description": "Filter matrix to a specific speed rating (e.g. 7 or 9)"
    }
  }
}

Retrieve the latest weekly disc golf retail sales rankings (Top 10) and weekly top risers/fallers by region (global, europe, americas, oceania, asia) based on aggregated sales from 40+ worldwide retailers.

{
  "type": "object",
  "properties": {
    "region": {
      "type": "string",
      "description": "Geographic sales region: 'global' (default), 'europe', 'americas', 'oceania', 'asia'",
      "enum": [
        "global",
        "europe",
        "americas",
        "oceania",
        "asia"
      ],
      "default": "global"
    },
    "limit": {
      "type": "integer",
      "description": "Number of top discs to return (1..10, default 10)",
      "default": 10
    }
  }
}

Retrieve rolling 4-week disc golf market movers including biggest disc risers, fallers, breakout discs entering the top 100, and brand momentum shifts.

{
  "type": "object",
  "properties": {
    "type": {
      "type": "string",
      "description": "Mover filter: 'all' (default), 'risers', 'fallers', 'breakouts', 'brands'",
      "enum": [
        "all",
        "risers",
        "fallers",
        "breakouts",
        "brands"
      ],
      "default": "all"
    },
    "limit": {
      "type": "integer",
      "description": "Maximum number of mover items to return per category (1..20, default 10)",
      "default": 10
    }
  }
}

Retrieve a specific disc golf disc's current weekly retail sales rank across regions (Global, Europe, Americas, Oceania, Asia) and its 4-week market momentum status.

{
  "type": "object",
  "properties": {
    "disc_id": {
      "type": "string",
      "description": "Target disc ID or slug (e.g. 'innova-destroyer', 'discraft-buzzz', 'axiom-envy')"
    }
  },
  "required": [
    "disc_id"
  ]
}