# Chessfolio

> Your whole chess life, one record. Connect chess.com, Lichess and your OTB (ECF) games, pull everything into one place, and see your chess through stats no single platform can show. Free to use.

## Key pages

- Home: https://chessfolio.io/
- Markdown version of the homepage: https://chessfolio.io/index.md
- Sign up: https://chessfolio.io/signup
- Sign in: https://chessfolio.io/login

## What Chessfolio does

- Pulls chess.com, Lichess and over-the-board (ECF) games into one record, with PGN upload for everything else
- Full history backfill on day one, nightly sync top-ups after
- One dashboard: multi-platform rating chart, accuracy trend, win/draw/loss splits, online vs over-the-board comparison
- Engine game review with accuracies, move classifications and each game's critical moments
- Lichess puzzle tracking alongside the games
- A weekly report every Friday: one honest summary of the week, delivered by email as a shareable mini-report page
- Chessfolio Embed (https://embed.chessfolio.io) puts live fixtures, results and league tables on chess club websites

## Agent access

Chessfolio has a real agent surface, read-only throughout. Two kinds of tool:

- Personal chess data (needs a token): your own stats, games (list, plus single-game detail with moves and review), ratings, problem opening lines, weekly report and puzzles. Under /api/v1/me/* and the MCP tools with auth "bearer".
- Public tournament tools (no token): a Chess-Results tournament snapshot, a Round-1 pairing estimate and a next-round Swiss pairing estimate (the real FIDE Dutch engine over the live standings). Under /api/v1/tournaments/* and the MCP tools with auth "none". The estimates are not official pairings and snapshots may be stale.

- REST API: https://chessfolio.io/api/v1 (OpenAPI: https://chessfolio.io/openapi.json)
- MCP server: https://chessfolio.io/api/mcp (streamable HTTP; personal tools use `Authorization: Bearer <token>`, the tournament tools need no auth)
- Create a token: sign in → Settings → API access. Tokens are shown once and revocable. Only personal data needs one.
- Human docs: https://chessfolio.io/developers
- Authentication details: https://chessfolio.io/auth.md
- Discovery: https://chessfolio.io/.well-known/api-catalog · /.well-known/mcp.json · /.well-known/agent-skills/index.json