# Fantasy Pundit

> Fantasy Pundit is a free AI-powered Fantasy Premier League commentary generator. Users paste a public FPL league URL or league ID and receive a football-style text or audio recap of the latest gameweek.

## Core Pages

- [Homepage](https://fantasypundit.lol/): Generate regular FPL gameweek commentary.
- [About](https://fantasypundit.lol/about/): Product background and operating context.
- [MCP Connector](https://fantasypundit.lol/connect/mcp/): Add Fantasy Pundit to Claude as a remote MCP connector.
- [Season Wrapped](https://fantasypundit.lol/season-wrapped): FPL Season Wrapped 2025/26 landing page and end-of-season mini-league review status.

## Agent Resources

- [API catalog](https://fantasypundit.lol/.well-known/api-catalog): RFC 9727 Linkset catalog for the public API.
- [OpenAPI description](https://fantasypundit.lol/.well-known/openapi.json): Machine-readable API contract.
- [API docs](https://fantasypundit.lol/docs/api/): Human-readable API guidance.
- [MCP connector guide](https://fantasypundit.lol/_agent/connect-mcp.md): Markdown setup guide for the Fantasy Pundit remote MCP connector.
- [OpenClaw and Hermes MCP setup](https://fantasypundit.lol/_agent/openclaw-hermes.md): Agent-readable setup snippets for OpenClaw and Hermes Agent.
- [MCP server metadata](https://fantasypundit.lol/.well-known/mcp/server.json): Registry-style metadata for the Fantasy Pundit remote MCP server.
- [Agent skills index](https://fantasypundit.lol/.well-known/agent-skills/index.json): Discoverable Fantasy Pundit agent skill.
- [Observability runbook](https://fantasypundit.lol/_agent/observability.md): MCP, API, rate-limit, and HQ telemetry contract for future agents.

## API Summary

The public API is hosted at `https://api.fantasypundit.lol`.

- Remote MCP connector: `https://api.fantasypundit.lol/mcp`
- MCP server metadata: `https://api.fantasypundit.lol/.well-known/mcp/server.json`
- `GET /health` checks service health.
- `GET /api/league-search?query={query}&page={page}` searches public FPL leagues.
- `POST /api/jobs/commentary` queues regular gameweek commentary.
- `POST /api/jobs/season-wrapped` queues season wrapped commentary.
- `GET /api/jobs/{jobId}` polls a queued job.
- `GET /audio/{audioKey}` retrieves generated MP3 audio.
- `GET /s/{shareToken}` retrieves a temporary shared job.

## Usage Preferences

Fantasy Pundit allows search indexing, real-time AI input/grounding, and AI model training.