Lichess.org Open Chess Intelligence MCP. Analyze player stats and track real-time game action.
Gemini Works with every AI agent you already use
…and any MCP-compatible client
Just plug in your AI agents and start using Vinkius.
Lichess.org Open Chess Intelligence gives your AI agent deep access to Lichess.org's real-time and historical chess data. You can monitor official tournament broadcasts, check live player statuses, analyze full match history (PGN), retrieve detailed player profiles across all variants, and even solve daily puzzles using natural conversation with your preferred client.
What your AI agents can do
Get daily puzzle
Retrieves the Lichess puzzle challenge available for the day.
Get leaderboards
Fetches top player rankings and scores across various chess variants (e.g., Blitz, Rapid).
Get player data
Gets the public profile data for any specified Lichess player.
List ongoing official tournament broadcasts and see which Grandmasters are playing on Lichess TV.
Retrieve a player's full match history, allowing you to pull PGN data for deep post-game analysis.
Fetch public profiles and current ratings for a Lichess user across all defined chess variants.
Pull the recent activity feed for any player, showing when they played or updated their profile.
List all members belonging to a specific Lichess team.
Check if multiple specified users are currently active and logged into the platform.
Ask AI about this MCP
Supported MCP Clients
OAuth 2.0 Compatible Gemini Waiting for input…
Lichess Open Chess Intelligence: 10 Tools for Data Analysis
These ten tools let your AI agent query everything from live tournament schedules to deep historical player match data, giving you total access to Lichess.org's intelligence.
Make your AI actually useful.
Add this MCP to Claude, Cursor, or Windsurf and your AI stops guessing. It gets real tools to look things up, take action, and handle the stuff you keep doing by hand.
Start using Lichess.org Open Chess Intelligence on Vinkius019d8453get daily puzzle
Retrieves the Lichess puzzle challenge available for the day.
019d8453get leaderboards
Fetches top player rankings and scores across various chess variants (e.g., Blitz, Rapid).
019d8453get player data
Gets the public profile data for any specified Lichess player.
019d8453get team members
Lists all usernames belonging to a specific Lichess team.
019d8453get tv channels
Identifies which Grandmasters or players are currently broadcasting live on Lichess TV.
019d8453get user activity
Retrieves a chronological log of recent actions taken by a player (e.g., profile changes, puzzle solves).
019d8453get user games
Pulls the complete match history for any given player.
019d8453get users online status
Checks and confirms if multiple specified users are currently online on Lichess.
019d8453list broadcasts
Lists all ongoing official tournament broadcasts that the platform is running.
019d8453list live streamers
Provides a list of chess streamers who are currently broadcasting live on Lichess.
Choose How to Get Started
Build a custom MCP for your own tools, or connect a ready-made integration from our catalog.
Build Your Own
Turn any API into an MCP. Import a spec, define Agent Skills, or deploy with MCPFusion.
- Import from OpenAPI, Swagger, or YAML specs
- Create Agent Skills with progressive disclosure
- Deploy to edge with MCPFusion framework
- Built in DLP, auth, and compliance on every call
- Real time usage dashboard and cost metering
- Publish to catalog or keep private
Make Your AI Do More
Start with Lichess.org Open Chess Intelligence, then connect any of our 4,800+ other servers whenever your AI needs more. One click, no limits.
- Use this MCP plus 4,800+ others, all in one place
- Add new capabilities to your AI anytime you want
- Every connection is secured and compliant automatically
- Track usage and costs across all your servers
- Works with Claude, ChatGPT, Cursor, and more
- New servers added to the catalog every week
Independent Platform Disclaimer: Vinkius is an independent platform and is not affiliated with, endorsed by, sponsored by, verified by, or otherwise authorized by Lichess.org. All third-party trademarks, logos, and brand names are the property of their respective owners. Their use on this website is strictly for informational purposes to identify service compatibility and interoperability.
VINKIUS INFRASTRUCTURE
Cloud Hosted
Managed infra
V8 Isolated
Sandboxed per request
Zero-Trust Proxy
No stored credentials
DLP Enforced
Policy on every call
GDPR Compliant
EU data residency
Token Compression
~60% cost reduction
Works with Claude, ChatGPT, Cursor, and more
The Model Context Protocol standardizes how applications expose capabilities to LLMs. Instead of operating in isolation, your AI gains direct access to external platforms, live data, and real-world actions through secure, standardized connections.
This server provides 10 capabilities that interface natively with Claude, ChatGPT, Cursor, and any MCP client. No middleware. No custom integration required.
Checking player stats shouldn't involve jumping between four different Lichess tabs.
Today, analyzing a single player means logging into the profile page, hitting the 'games' tab for PGNs, finding the team roster separately, and then checking the main status board to see if they’re actually online. You spend more time clicking than you do reading.
With this MCP server, your agent handles that entire workflow in one prompt. It runs `get_player_data` for stats, pulls `get_user_games` for PGNs, and confirms status using `get_users_online_status`. You just get the data you need—no clicking required.
Using Lichess.org Open Chess Intelligence MCP Server: Get game insights from history.
Manual analysis involves downloading dozens of PGN files, pasting them into a separate board viewer, and manually calculating trends across different variants (Blitz vs. Rapid). It's slow, tedious, and error-prone.
Now you ask the agent to run `get_user_games` and process the data. You get structured JSON output containing move sequences, technical results, and metadata—ready for immediate use in your application or report.
What you can do with this MCP connector
Lichess Open Chess Intelligence gives your AI agent deep access to Lichess.org's entire operational data set. You don't need messy web scraping or some clunky third-party API just to get basic stats; this server connects you directly to the source, letting your client perform complex actions on live and historical chess data.
Monitoring Live Action and Statuses
You can track who’s playing right now. By running list_broadcasts, you'll see every official tournament currently running on the platform. Want to know which Grandmasters are streaming? Use get_tv_channels to identify exactly who's broadcasting live on Lichess TV at this moment. If you need a list of all streamers, run list_live_streamers; that’ll give you a feed of everyone currently broadcasting their stream.
When you need to know if a specific group is active—say, checking your whole squad—you use get_users_online_status to confirm if multiple specified users are logged into the site and online right now.
Analyzing Player Performance and Metrics
Want to check out a player's overall standing? You run get_leaderboards and you pull up top rankings and scores across every major chess variant, like Blitz or Rapid. For deep dives on an individual, your agent can use get_player_data to grab the entire public profile for any Lichess user. This includes their current ratings and historical details across all defined variants of play.
Auditing History and Activity Logs
When you need to audit a player or track performance trends, you've got two main tools. First, run get_user_games to pull the complete match history for any given player. This gives you raw PGN data—enough material for serious post-game analysis of tactical patterns and mistakes. Second, if you need to see what a user has been up to recently, use get_user_activity.
This pulls a chronological log detailing recent actions taken by the player, whether they solved a puzzle, updated their profile, or just logged in.
Community and Puzzle Data
For team-based intelligence, you run get_team_members on a specific team's name. That lists every single username that belongs to that group. If you need to know what the daily challenge is—or if you want your agent to solve it for practice—you use get_daily_puzzle, and it retrieves today's available Lichess puzzle challenge.
This setup lets your AI client handle all the data fetching. It pulls everything from listing ongoing tournaments via list_broadcasts and checking which players are live on TV using get_tv_channels. You can grab a user’s full history with get_user_games, or just check their general profile stats using get_player_data. Need to know what they did yesterday? Run get_user_activity.
Want to see who's playing right now and if your buddies are online, you use get_users_online_status and list_live_streamers. If you're tracking a whole crew, you get all their details with get_team_members, and even the current top scores through get_leaderboards. You can also nail down today's puzzle using get_daily_puzzle. It’s everything, handled by your agent.
No fluff, just data.
019d8453-a799-7065-ac18-391a0892a19b 
How Lichess.org Open Chess Intelligence MCP Works
- 1 Subscribe to this server on Vinkius.
- 2 If you need higher limits, optionally enter your Lichess Personal Access Token for rate limiting control.
- 3 Start making requests from Claude, Cursor, or any MCP-compatible client by asking the agent to perform a specific action (e.g., 'What did UserX do yesterday?').
The bottom line is that your AI agent handles all the messy API calls and data structuring; you just talk to it in natural language.
Who Is Lichess.org Open Chess Intelligence MCP For?
This server is for people who need structured, massive amounts of data—not casual players. Think eSports coordinators running live tournaments, advanced chess coaches building curriculum, or dedicated data analysts tracking player trends over years of play. If you spend time looking at leaderboards and PGNs, this is for you.
Monitors live streams using get_tv_channels to ensure all scheduled tournaments are running smoothly and tracks player status with get_users_online_status before a match starts.
Uses get_user_games and get_player_data to pull the last 10 matches of a student, analyzing PGNs for specific tactical errors or patterns.
Runs deep audits by fetching player data (get_player_data) and comparing historical ratings with current tournament leaderboard rankings using get_leaderboards.
What Changes When You Connect
- See live tournament activity instantly. Using
list_broadcastslets your agent know exactly which official events are running, so you don't have to check the main calendar page. - Audit detailed player history easily. The
get_user_gamestool fetches match records and PGN data for any user, giving you everything needed for deep tactical analysis without manual downloading. - Know who’s online right now. Instead of guessing or refreshing a status board, use
get_users_online_statusto verify if multiple players are actively logged in before starting a session. - Track community groups efficiently. The
get_team_memberstool quickly lists all members of a specific team, which is crucial for organizing tournament rosters or finding contacts. - Stay current with puzzles and rankings. You can always get the daily challenge via
get_daily_puzzle, and useget_leaderboardsto pull fresh ranking data immediately.
Real-World Use Cases
Investigating a Rival Player's Weaknesses
A coach needs to analyze a rival. They ask their agent to run get_user_games for the player, pulling 20 recent matches. The agent then uses get_player_data alongside this data to pinpoint low-rated variants or specific patterns in PGNs that indicate weaknesses.
Monitoring a Live Championship
An eSports organizer needs real-time feed info. They ask the agent to run list_broadcasts and get_tv_channels. The agent instantly identifies all active boards, noting which Grandmasters are currently playing on Lichess TV.
Checking Roster Status for an Event
A tournament director needs to know if the core team members are available. They run get_users_online_status and cross-reference it with the list of people who need to attend, ensuring everyone is logged in before setup.
Finding a Missing Team Member
A team captain needs to confirm roster details. They run get_team_members for their squad's name, getting an immediate list of all associated users, preventing missed communication or unauthorized additions.
The Tradeoffs
Assuming data exists
Trying to ask the agent about a player’s 'monthly engagement score' because they read it on a blog.
→
The server only provides verified data. To check activity, you must use get_user_activity or analyze PGNs from get_user_games. Don't assume a metric that isn't in the toolset.
Ignoring variants
Only checking the overall rating, missing out on specialized skills (e.g., Blitz vs. Rapid).
→
Always ask for get_player_data because it includes ratings and profiles across all game types, giving you a complete picture.
Using the wrong status tool
Asking if a player is 'active' generally instead of checking their actual online state.
→
Use get_users_online_status to check for real-time presence, which confirms multiple users are logged in and available now.
When It Fits, When It Doesn't
Use this server if your primary need is structured, deep access to historical or live chess data. If you're building a tool that requires cross-referencing player ratings, activity logs (get_user_activity), or broadcasting status (list_broadcasts), this is essential. Don't use it if all you want is a simple score—just pulling the get_leaderboards result is usually enough. If your goal is high-frequency transactional data (like submitting a single move in a game), you might need a dedicated gaming API instead, but for analysis and monitoring, this server is definitive.
Common Questions About Lichess.org Open Chess Intelligence MCP
How do I check who is playing live on Lichess TV using get_tv_channels? +
You ask the agent to run get_tv_channels. It will return a list of currently broadcasting Grandmasters and which specific chess channel (Blitz, Bullet) they are in. This keeps you updated without refreshing.
Can I get all recent matches for 'UserX' using get_user_games? +
Yes, running get_user_games fetches the full match history for UserX. The output includes technical results and PGN links for deep analysis.
Does list_live_streamers only show professional players? +
No, list_live_streamers lists all streamers currently broadcasting on Lichess TV, giving you a full view of the community's live activity, not just top professionals.
What if I want to know if multiple people are online? Should I use get_users_online_status? +
Yes, get_users_online_status is exactly for that. You list the usernames and it checks their real-time login status simultaneously.
Is there a way to see a player's full team roster? How do I use get_team_members? +
To list all members, you run get_team_members and provide the specific team name. The agent returns a clean list of every username on that squad.
When I run a high volume of checks using get_player_data, how do I handle rate limits? +
You need to use your Lichess Personal Access Token. The documentation specifies passing this token for higher request limits. It’s essential for running deep audits across many players at once.
What data points does get_daily_puzzle return? +
It gives you the puzzle board state, its difficulty rating, and a correct solution. This lets your agent analyze specific tactical patterns without needing full match history.
How do I use list_broadcasts to find information about upcoming tournaments? +
The tool lists ongoing official tournament broadcasts. It helps you track major global championships and see the current event status, which is different from listing individual live streamers.
Can my AI agent actually monitor a specific world championship game as it happens? +
Yes! Use the list_broadcasts tool to find the tournament and then identify the specific match ID. The agent will retrieve technical updates and moves directly from the Lichess official transmission feed.
Do I need a paid account to access the Lichess technical data? +
No. Lichess is a non-profit organization and all public data is free. However, providing a Personal Access Token (PAT) is highly recommended to ensure stable performance and higher rate limits during deep analysis sessions.
How do I see who are the top players currently competing in a specific variant like 'Crazyhouse'? +
Simply ask the agent to run the get_leaderboards or get_top_10_variant_leaderboard tool. It will retrieve the elite rankings for all supported variants, including the player's rating and title status.
Use it with your favorite AI tools
Connect this server to Cursor, Claude, VS Code, and more.