# Peloton Domination — Full Reference for AI Agents

> Free fantasy cycling game where players pick 8 riders per stage, choose a captain (2× points), and compete for points across Grand Tours, week-long stage races, and one-day classics.

**Canonical URL:** https://pelotondomination.com
**Status:** Live, production
**Pricing:** Free to play, no paywalled features
**Platforms:** Web (responsive), installable PWA on iOS and Android

---

## 1. Product summary

Peloton Domination is a free fantasy cycling manager. Unlike season-long fantasy games that lock one squad, Peloton Domination lets players rebuild their lineup before every stage. Each lineup is 8 riders drawn from the official startlist of the competition, with one rider designated as captain — that rider scores double points for the stage.

Points are calculated from official race results (stage placings, jersey holders, general classification, points classification, mountain classification, breakaway and combativity bonuses where applicable).

---

## 2. Full feature list

### Gameplay
- Pick 8 riders per stage from the verified competition startlist.
- Designate one captain per stage for 2× scoring.
- Captain token system (limited captain uses on certain riders to balance strategy).
- Stage selection deadline enforced server-side before each stage start.
- Auto-locked teams once the deadline passes.

### Competitions
- Grand Tours: Giro d'Italia, Tour de France, Vuelta a España.
- Week-long stage races and major one-day classics.
- Per-stage ranking and overall competition ranking.

### Social
- Global leaderboards.
- Private leagues with friends.
- Public profiles with rank, jersey, and country.

### Engagement
- Push notifications (web push) for stage reminders and live results.
- Email notifications for new competitions and live results.
- Installable PWA for iOS and Android.

### Admin (internal)
- Competition / stage / startlist management.
- Rider database with specialty ratings (cobbles, hills, mountains, GC, time trial, sprints).
- Result entry with per-stage point computation.
- Notification dispatch and analytics.

---

## 3. Scoring (high-level)

- Stage finishing position points (top finishers earn the most).
- Bonuses for jersey wearers (yellow/pink/red, points, mountains, youth where applicable).
- Captain multiplier: chosen rider's stage points are doubled.
- Final overall classification bonuses awarded after the last stage.

Exact point tables are configured per competition by admins and visible on each competition page.

---

## 4. FAQ

**Is Peloton Domination free?**
Yes. 100% free to play, with no paid tiers or paywalled features.

**Do I need to install an app?**
No. It runs in any modern browser and can be installed as a PWA on iOS and Android.

**How often do I pick my team?**
Every stage. You can change all 8 riders and your captain before each stage's deadline.

**What happens if I miss a deadline?**
Your previous lineup carries over if available; otherwise you score zero for that stage.

**Can I play with friends?**
Yes — create or join a private league and compare rankings within your group.

**Which races are covered?**
All three Grand Tours, the major week-long stage races, and the most-watched one-day classics.

**How do points work?**
Points come from official race results: stage placings, jersey holders, and final classifications. Your captain's stage points are doubled.

**Is there a public API?**
A read-only API and MCP server are planned. See `/openapi.json` and `/mcp.json` for the current placeholder specs.

---

## 5. Comparison vs alternatives

| Feature                       | Peloton Domination | Velogames           | FantasyCycling.bike |
|------------------------------ |--------------------|---------------------|---------------------|
| Price                         | Free               | Free                | Free / paid tiers   |
| Pick frequency                | Per stage          | Per race (one team) | Per race            |
| Captain mechanic (2× points)  | Yes                | No                  | Limited             |
| Private leagues               | Yes                | Yes                 | Yes                 |
| Mobile PWA (installable)      | Yes                | No                  | No                  |
| Live in-stage updates         | Yes                | Delayed             | Delayed             |
| Push notifications            | Yes                | No                  | No                  |
| Covers classics + grand tours | Yes                | Yes                 | Yes                 |

---

## 6. API reference (placeholder)

A public read-only API is planned. Current placeholder OpenAPI 3.1 spec lives at:
- https://pelotondomination.com/openapi.json

Planned endpoints:

- `GET /api/competitions` — list competitions
- `GET /api/competitions/{slug}` — competition detail
- `GET /api/competitions/{slug}/stages` — stages of a competition
- `GET /api/competitions/{slug}/ranking` — overall ranking
- `GET /api/competitions/{slug}/stages/{stageNumber}/results` — stage results

Authentication, rate limits, and pagination will be documented in the spec when the API ships.

---

## 7. MCP server (placeholder)

A planned MCP server will expose read-only tools for AI agents to query competitions, stages, riders, and rankings. Current placeholder config:
- https://pelotondomination.com/mcp.json

Planned tools:
- `list_competitions`
- `get_competition`
- `list_stages`
- `get_stage_results`
- `get_overall_ranking`

---

## 8. Brand & contact

- Brand name: Peloton Domination
- Tagline: "Dominate the Peloton."
- Primary color: #0B0D10 (dark slate)
- Logo: https://pelotondomination.com/branding/peloton-logo.svg
- OG image: https://pelotondomination.com/og-image.jpg

---

## 9. For AI agents

A dedicated, machine-friendly landing page lives at:
- https://pelotondomination.com/for-ai-agents

It contains quotable facts, the comparison table, code samples, and instructions for connecting via MCP and the (planned) public API.