INDIVIDUAL MCP TOOL

get_weekly_report

The user's most recent Friday weekly report as its frozen payload: per-source sections (chess.com / Lichess / OTB) with games, rating lines, best win and toughest defeat, plus puzzles — exactly what the email and the public share page render, with the share URL included.

chessfolio.ionone authenticationAvailability not checked

LIVE ENDPOINT

https://chessfolio.io/api/mcp

No auth detected

Connect to this endpoint to inspect the live schema for get_weekly_report and invoke it with your own arguments.

Indexed input schema

{}

Risk classification

Potential side effects detected · medium confidence · heuristic, not a guarantee.

A tool name or description suggests retrieving external content.
A tool name or description suggests sending messages.

Parent server

chessfolio.io

CONNECT WITH APPROVAL

Client installation

Review this server and its permissions before adding it. Secret placeholders must be set locally.

Codex

~/.codex/config.toml

[mcp_servers.mcp-typescript-server-on-vercel]
url = "https://chessfolio.io/api/mcp"
enabled = true

Claude Code

.mcp.json

{
  "mcpServers": {
    "mcp-typescript-server-on-vercel": {
      "type": "http",
      "url": "https://chessfolio.io/api/mcp"
    }
  }
}

Claude Desktop

Settings → Connectors → Add custom connector

Name: mcp-typescript-server-on-vercel
Remote MCP URL: https://chessfolio.io/api/mcp

Add this remote URL as a custom connector in Claude Desktop. Availability depends on the user plan and workspace policy.

Cursor

.cursor/mcp.json

{
  "mcpServers": {
    "mcp-typescript-server-on-vercel": {
      "url": "https://chessfolio.io/api/mcp"
    }
  }
}

Visual Studio Code

.vscode/mcp.json

Add to Visual Studio Code

{
  "servers": {
    "mcp-typescript-server-on-vercel": {
      "type": "http",
      "url": "https://chessfolio.io/api/mcp"
    }
  }
}

Generic MCP

Client-specific MCP configuration

{
  "name": "mcp-typescript-server-on-vercel",
  "transport": "streamable-http",
  "url": "https://chessfolio.io/api/mcp"
}

MCP Inspector

Run the official MCP Inspector locally and enter the indexed Streamable HTTP endpoint.

Related tools

get_profile — The authenticated user's Chessfolio profile: display name, linked platform usernames, connected sources with sync freshness (last_synced_at), and total game count.
get_chess_stats — Aggregate statistics over the user's games for a chosen window: win/draw/loss by colour, online vs over-the-board comparison, performance rating, records and streaks, recent form, weekday performance, opponent-strength breakdown, game-length breakdown, top openings, monthly form and average accuracy.
get_rating_progress — Rating series per provider and time control (including ECF over-the-board), each with start/end/delta over the window.
list_games — Paged list of the user's games (50 per page) across chess.com, Lichess, ECF (OTB), manual and PGN imports, with filters matching the chessfolio.io games library: provider, result, colour, time class, date range, move-count range, opening, opponent, opening-line prefix (lineMoves, as returned by get_problem_lines) and free-text search.
get_game — One of the user's games in full: the same summary fields as list_games plus its moves and, where a Chessfolio review exists, a review summary.
get_game_analysis — Move-by-move engine analysis of one of the user's reviewed games (the deterministic detail behind get_game's review summary).
get_critical_moments — The teachable positions from one of the user's reviewed games, so you do not have to read every ply to find what matters.
attach_pgn — Attach one complete PGN to an existing game in the authenticated user's Chessfolio library.