Lichess MCP server
Player ratings and records from Lichess. Add one address to your AI assistant and it can call the tool below itself, with your FoxAPIs key. It costs the same credits as the REST API, and an answer with no data is not charged.
Server address
https://foxapis.com/mcp/data/lichess
Streamable HTTP, bearer key in the Authorization header. This address carries only the Lichess tool; https://foxapis.com/mcp/data carries all of them, and ?source=lichess,github picks several.
What you can ask
Five prompts to give your assistant once the server is added:
- What are DrNykterstein's Lichess ratings?
- How many rated games has this Lichess player played?
- When did the Lichess user I name join, and what is their title?
- Compare the bullet ratings of two Lichess players.
- Which Lichess variant has this player played most?
The tool your assistant gets
| Tool | What it returns | Inputs | Credits a call |
|---|---|---|---|
lichess_player | A Lichess player: ratings per variant, game counts, title and account age, by user name. | username (required) | 1 |
Credits come from the same file as the pricing page. Plans and top-ups are on pricing.
Set it up
Use your FoxAPIs key (it starts with fxp_) as the bearer token. Get one free at foxapis.com/trial.
Claude Code
Run in a terminal. Its docs.
claude mcp add --transport http foxapis-data https://foxapis.com/mcp/data/lichess \ --header "Authorization: Bearer YOUR_KEY"
The Claude Code docs show this form (--transport http, name, URL, --header) for a server that takes a bearer token.
Cursor
.cursor/mcp.json in a project, or ~/.cursor/mcp.json for every project. Its docs.
{
"mcpServers": {
"foxapis-data": {
"url": "https://foxapis.com/mcp/data/lichess",
"headers": {
"Authorization": "Bearer YOUR_KEY"
}
}
}
}Cursor's remote-server example uses a url and a headers object.
VS Code (Copilot)
.mcp.json at the workspace root, or ~/.copilot/mcp-config.json. Its docs.
{
"mcpServers": {
"foxapis-data": {
"type": "http",
"url": "https://foxapis.com/mcp/data/lichess",
"headers": {
"Authorization": "Bearer YOUR_KEY"
},
"tools": [
"*"
]
}
}
}Do not store a real key in a file you share.
Cline
cline_mcp_settings.json (open it from Cline's MCP Servers panel). Its docs.
{
"mcpServers": {
"foxapis-data": {
"type": "streamableHttp",
"url": "https://foxapis.com/mcp/data/lichess",
"headers": {
"Authorization": "Bearer YOUR_KEY"
},
"disabled": false,
"autoApprove": []
}
}
}Cline's docs say that leaving type out selects the older SSE transport, so keep type.
Zed
settings.json (Zed: open settings). Its docs.
{
"context_servers": {
"foxapis-data": {
"url": "https://foxapis.com/mcp/data/lichess",
"headers": {
"Authorization": "Bearer YOUR_KEY"
}
}
}
}
n8n
an MCP Client Tool node in a workflow. Its docs.
Endpoint: https://foxapis.com/mcp/data/lichess Server transport: HTTP Streamable Authentication: Header Auth Name: Authorization Value: Bearer YOUR_KEY
Not run by us: the fields are the ones n8n's MCP Client Tool documents. The server speaks Streamable HTTP.
Claude Desktop and ChatGPT
Not covered here: their custom-connector screens ask for sign-in (OAuth) or no authentication, and this server takes a bearer key in a header, so it works best in the clients above. We have not tested it in either.
A real answer
The lichess_player tool called once through a real MCP client session on 20 November 2026 with the input {"username":"DrNykterstein"}. Long text is cut and lists are cut to three items for display; it is not invented.
{
"platform": "lichess",
"username": "DrNykterstein",
"title": "GM",
"patron": true,
"online": false,
"ultra_bullet": {
"rating": 2406,
"games": 92,
"progress": -7,
"provisional": true
},
"bullet": {
"rating": 3263,
"games": 9585,
"progress": 23,
"provisional": false
},
"blitz": {
"rating": 3194,
"games": 609,
"progress": 70,
"provisional": true
},
"rapid": {
"rating": 2500,
"games": 0,
"progress": 0,
"provisional": true
},
"classical": {
"rating": 2500,
"games": 0,
"progress": 0,
"provisional": true
},
"correspondence": {
"rating": 1500,
"games": 0,
"progress": 0,
"provisional": true
},
"total_games": 10455,
"total_rated": 10440,
"total_wins": 7212,
"total_losses": 2409,
"total_draws": 834,
"play_time_hours": 325.1,
"created_date": "2018-12-06",
"last_seen_date": "2026-11-15",
"lichess_url": "https://lichess.org/@/DrNykterstein",
"time_controls_glossary": {
"ultra_bullet": "Under 30 seconds per game",
"bullet": "1-2 minutes per game",
"blitz": "3-5 minutes per game",
"rapid": "8-25 minutes per game",
"classical": "25+ minutes per game",
"correspondence": "Days per move"
},
"credits_used": 1,
"latency_ms": 234
}
Charged: 1 credit.
Try it free
Runs the lichess_player call with the sample input below. No key and no sign-up; a few runs a day per visitor.
{
"username": "DrNykterstein"
}
Other data-source MCP servers
Shopify stores · YouTube · Substack · Bluesky · Mastodon · Twitch · all of them
Free to start: 100 credits, no card. Then from $10. Credits you buy never expire.
Get my free keyThe same data over REST: Lichess player. More: all MCP servers · people and company tools