INDIVIDUAL MCP TOOL

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.

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_profile and invoke it with your own arguments.

Indexed input schema

{}

Risk classification

Inferred read-only · medium confidence · heuristic, not a guarantee.

No write-capable action terms were found; this is not proof that invocation has no side effects.

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_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.
request_game_review — Ask Chessfolio to run its engine review over one of the authenticated user's games.