convez.ai
MCP ServerIntegração & APIsIntermediário
alegerber

Chess.com & Lichess MCP Server

alegerber/chess-com-lichess-org-mcp

Acesso via MCP às APIs de xadrez online Chess.com e Lichess

Ver no GitHub
InicialPluginScore · de 0 a 100

Servidor MCP em TypeScript que expõe as APIs públicas do Chess.com e Lichess.org para assistentes de IA. Permite consultar perfis de jogadores, histórico de partidas, ratings, puzzles, torneios e dados de clubes de ambas plataformas via Model Context Protocol.

Instalação

$npx convez-ai alegerber/chess-com-lichess-org-mcp

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
0
Forks
0
Acompanhando
0
Saúde
57%
Último commit
há 3 meses
Versão
v2.0.2
Issues abertas
1
Contribuidores
4

Casos de uso

  • Análise de perfil e histórico de jogadores de xadrez
  • Busca de puzzles e dados de torneios em tempo real
  • Integração de dados de xadrez em assistentes de IA
  • Consulta de ratings, estatísticas e atividade de jogadores

Veredito

Servidor MCP sólido e bem documentado que integra duas grandes plataformas de xadrez online. Ideal para construtores que precisam enriquecer assistentes de IA com dados de jogadores, partidas e competições — cobertura abrangente (83 tools) de ambas APIs.

README

A tradução para o português deste README ainda está na fila.

chess-com-lichess-org-mcp

An MCP (Model Context Protocol) server that provides access to the Chess.com Published-Data API and the Lichess API. This gives LLMs the ability to look up player profiles, game history, stats, clubs, tournaments, puzzles, leaderboards, and more from both platforms.

Tools

Chess.com (29 tools)

ToolDescription
get_player_profileGet a player's profile (username, title, FIDE, status, etc.)
get_player_statsGet a player's ratings and win/loss/draw records across all game types
is_player_onlineCheck if a player is currently online
get_current_daily_gamesGet daily chess games a player is currently playing
get_games_to_moveGet daily games where it's the player's turn
get_game_archivesList available monthly game archives for a player
get_monthly_archivesGet all games from a specific month
get_monthly_archive_pgnGet a whole month of games as a single PGN document
get_player_clubsGet clubs a player belongs to
get_player_tournamentsGet a player's tournament history
get_player_matchesGet a player's team match history
get_titled_playersList players with a specific title (GM, IM, FM, etc.); paginate with offset/limit
get_club_profileGet a club's profile information
get_club_membersGet a club's members by activity level
get_club_matchesGet a club's team matches
get_tournamentGet tournament details
get_tournament_roundGet details about a tournament round
get_tournament_round_groupGet details about a tournament round group
get_team_matchGet daily team match details
get_team_match_boardGet a specific board from a daily team match
get_live_team_matchGet live team match details
get_live_team_match_boardGet a specific board from a live team match
get_country_profileGet a country's profile
get_country_playersList players from a country; paginate with offset/limit
get_country_clubsList clubs from a country; paginate with offset/limit
get_daily_puzzleGet today's daily puzzle
get_random_puzzleGet a random puzzle
get_streamersList Chess.com streamers
get_leaderboardsGet leaderboards for all game types

Lichess (54 tools, +1 with LICHESS_TOKEN)

ToolDescription
lichess_get_userGet a user's profile, ratings across all variants, game counts, and bio
lichess_get_user_statusCheck if users are online, playing, or streaming (up to 100)
lichess_get_rating_historyGet rating history across all variants with daily data points
lichess_get_perf_statsGet detailed performance stats: best wins, worst losses, streaks
lichess_get_user_activityGet recent activity: games, tournaments, practice, etc.
lichess_get_user_gamesGet recent games with optional filters (rated, variant, color); format: pgn for raw PGN
lichess_get_gameGet a specific game by its 8-character ID; format: pgn for raw PGN
lichess_get_current_gameGet a user's current ongoing game or last played game
lichess_get_leaderboardsGet top 10 players across all variants
lichess_get_leaderboardGet top N players for a specific variant/speed
lichess_get_daily_puzzleGet today's daily puzzle with solution and themes
lichess_get_puzzleGet a specific puzzle by ID
lichess_get_next_puzzleGet a fresh puzzle, optionally by theme/difficulty
lichess_get_storm_dashboardGet a user's Puzzle Storm statistics
lichess_get_teamGet a team's profile, description, and member count
lichess_search_teamsSearch for teams by name
lichess_get_user_teamsGet all teams a user is a member of — registered only when LICHESS_TOKEN is set, since /api/team/of is OAuth-only
lichess_get_team_membersGet the members of a Lichess team
lichess_get_popular_teamsList the most popular teams (paginated)
lichess_get_team_swiss_tournamentsList a team's Swiss tournaments
lichess_get_team_arena_tournamentsList a team's Arena tournaments
lichess_get_current_tournamentsGet the current tournament schedule
lichess_get_tournamentGet details about a specific arena tournament
lichess_get_user_tournamentsGet tournaments a user has played in
lichess_get_tv_channelsGet the featured game on each TV channel
lichess_get_tv_gamesGet best ongoing games from a specific TV channel
lichess_get_streamersGet currently live streamers on Twitch and YouTube
lichess_get_crosstableGet head-to-head record between two users
lichess_get_cloud_evalGet cloud engine evaluation for a FEN position
lichess_get_fide_playerLook up a FIDE player by numeric ID (name, federation, title, ratings)
lichess_search_fide_playersSearch FIDE players by name
lichess_autocomplete_playersResolve/disambiguate Lichess usernames from a partial term
lichess_export_games_by_idsExport many games at once by ID list (JSON or PGN)
lichess_get_usersFetch many users at once by username list (compact summary)
lichess_get_swissGet a Swiss tournament's info (status, rounds, clock, players)
lichess_get_swiss_resultsGet a Swiss tournament's final standings (top 100)
lichess_get_swiss_gamesExport a Swiss tournament's games (JSON or PGN)
lichess_export_swiss_trfExport a Swiss tournament in FIDE TRF(x) format
lichess_get_tournament_resultsGet an Arena tournament's final standings (top 100)
lichess_get_tournament_teamsGet a team-battle Arena's per-team standings
lichess_get_tournament_gamesExport an Arena tournament's games (JSON or PGN)
lichess_get_simulsList current simultaneous exhibitions (simuls)
lichess_get_user_studiesList a user's public studies (metadata)
lichess_export_study_pgnExport a whole public study as PGN (all chapters)
lichess_export_study_chapter_pgnExport a single study chapter as PGN
lichess_get_broadcastsList official broadcasts (live tournament relays)
lichess_get_top_broadcastsList featured broadcasts (active/upcoming/past)
lichess_get_broadcasts_by_userList broadcasts created by a user
lichess_get_broadcastGet a broadcast tournament's metadata and rounds
lichess_get_broadcast_roundGet a broadcast round's games/players as JSON
lichess_get_broadcast_round_pgnGet a broadcast round's live PGN feed
lichess_get_broadcast_pgnGet a whole broadcast tournament as a single PGN
lichess_opening_explorerLook up a position in the Opening Explorer (masters/lichess/player)
lichess_get_masters_game_pgnGet the PGN of an OTB master game from the Opening Explorer
lichess_tablebaseEndgame tablebase lookup (WDL/DTZ/DTM) for a FEN (standard/atomic/antichess)

Install

No clone or build required — run the published package with npx.

Claude Code

claude mcp add chess-mcp -- npx -y chess-com-lichess-org-mcp

Claude Desktop

Add the following to your config (~/Library/Application Support/Claude/claude_desktop_config.json on macOS):

{
  "mcpServers": {
    "chess-mcp": {
      "command": "npx",
      "args": ["-y", "chess-com-lichess-org-mcp"]
    }
  }
}

From source (development)

npm install
npm run build

Then point the MCP config at the built entry point — command: node, args: ["/absolute/path/to/chess-com-lichess-org-mcp/dist/index.js"].

Optional: Lichess OAuth token

The server is zero-config and auth-less by default — every tool above (except one) hits public endpoints and needs no login.

A few Lichess endpoints are OAuth-only. To enable the tools that need them, set a LICHESS_TOKEN environment variable to a Lichess personal access token (no scopes required for /api/team/of):

{
  "mcpServers": {
    "chess-mcp": {
      "command": "npx",
      "args": ["-y", "chess-com-lichess-org-mcp"],
      "env": { "LICHESS_TOKEN": "lip_xxxxxxxxxxxx" }
    }
  }
}
  • When set, the token is sent as Authorization: Bearer <token> only on lichess.org requests (never to the separate Opening Explorer / Tablebase hosts), and lichess_get_user_teams is registered.
  • When unset, behavior is unchanged: the token-only tool is simply absent from the tool list, and all public tools work as before.

Usage examples

Once configured, you can ask your LLM things like:

Chess.com:

  • "What is Hikaru's Chess.com rating?"
  • "Show me Magnus Carlsen's recent blitz games on Chess.com"
  • "Who are the top players on the Chess.com leaderboard?"
  • "Get today's Chess.com daily puzzle"
  • "List all Grandmasters on Chess.com"

Lichess:

  • "Show me DrNykterstein's Lichess profile"
  • "What's the head-to-head record between DrNykterstein and Firouzja2003 on Lichess?"
  • "Get the Lichess daily puzzle"
  • "Who are the top bullet players on Lichess?"
  • "What games are currently featured on Lichess TV?"
  • "Get the cloud evaluation for this position: rnbqkbnr/pppppppp/8/8/4P3/8/PPPP1PPP/RNBQKBNR b KQkq - 0 1"

Cross-platform:

  • "Compare Hikaru's ratings on Chess.com and Lichess"
  • "Get today's daily puzzle from both Chess.com and Lichess"

Notes

  • Both APIs are read-only and free to use. No API keys are required for the public endpoints; an optional LICHESS_TOKEN unlocks a few OAuth-only Lichess reads.
  • Chess.com: Rate limiting applies to parallel requests. Data may be cached for up to 12-24 hours.
  • Lichess: Requests are serial (one at a time). A 429 response means you should wait ~1 minute. Game exports stream as NDJSON, or pass format: pgn to lichess_get_game / lichess_get_user_games for raw PGN ready for engine analysis.

License

MIT

Ver o original no GitHub

Bom para

Relacionados