The chess MCP server for Claude, Codex, Gemini, Copilot and other AI assistants
Ask for the video. Your assistant makes it. ChessMotion MCP connects Claude, Codex, Gemini CLI, GitHub Copilot, Cursor and other MCP clients to your ChessMotion account. Ask in plain words for a short of your last win, a puzzle from a PGN or a link to the whole game, and the assistant imports the game, sets up the project and renders it — on your plan, with your credits.
Ask for the video. Your assistant makes it.
ChessMotion MCP connects Claude, Codex, Gemini CLI, GitHub Copilot, Cursor and other MCP clients to your ChessMotion account. Ask in plain words for a short of your last win, a puzzle from a PGN or a link to the whole game, and the assistant imports the game, sets up the project and renders it — on your plan, with your credits.
Connected in three steps.
No code to write and nothing to install on ChessMotion’s side. A key, one line in your client, and a sentence.
- Make a key: In Settings → Agents & API keys, choose New API key, give it a name and pick Create videos. Copy the key: it is shown once.
- Add the server: Give your MCP client the address https://chessmotion.com/api/mcp and the key as an Authorization header. In Claude Code and Gemini CLI that is one command.
- Ask: Tell the assistant what you want to make. It calls the tools, tells you what it did and hands you the file or the link.
In Claude Code: claude mcp add --transport http chessmotion https://chessmotion.com/api/mcp --header "Authorization: Bearer cmak_…"
Things you can ask.
Plain requests, in your own words. The assistant works out which tools to call and in which order, and asks you when something is missing.
- Import my last Lichess win and make a 9:16 short of the final ten moves.
- Turn this PGN into a puzzle video that stops before White’s winning move, then plays the solution.
- How much would a Full HD MP4 of this game cost? Don’t render it yet.
- Make a square video of the game with the black pieces at the bottom and a track from the music library.
- Share the whole game as an unlisted replay link I can send to my students.
- Look at my five most recent Chess.com games and tell me which moment is worth a short.
What happens when you ask
- Import: The game comes from a Chess.com or Lichess link, a PGN, or your recent games. Free, as in the app.
- Project: A video project is made from the game, on a template your plan can use.
- Set up: The moves to show, the board, the pieces, the orientation, music, text and captions — the editor’s own settings.
- Price: Before anything is charged, the assistant can ask what the render costs and whether your balance covers it.
- Render: The video renders on ChessMotion’s servers, exactly like an export from the editor.
- Deliver: The finished MP4 or GIF comes back to the assistant, or the game becomes an interactive replay link.
The tools your assistant gets.
Each tool is one thing ChessMotion already does in the app, with its own inputs. The assistant only sees the tools the key’s scopes allow.
- Games: Your recent Chess.com and Lichess games, from the usernames saved in your settings, or any game from a link or a PGN. Importing is free. (get_recent_games, list_games, get_game_facts, import_game).
- Analysis: Stockfish analysis of one of your games, to find the moments worth showing. It charges no credits. (analyze_game_for_content, get_game_analysis).
- Looks: The templates, boards, piece sets, music and Brand Kits your plan can use, with what each template can show. (list_available_templates, list_music_tracks, list_brand_kits).
- Projects: A video project from a game, and the editor’s settings for it: template, board, pieces, moves to show, music, text, captions and Brand Kit. (create_video_project, list_video_projects, get_video_project, configure_video_project, archive_project).
- Renders: The price first, then an MP4, a 9:16 vertical video or a GIF, and the finished file. (quote_render, render_video, get_render_status, download_render).
- Replays: An interactive replay link anyone can open, unlisted or public, and closing it again. (create_interactive_replay, get_interactive_replay, update_interactive_replay).
- Account: Which key this is, its plan, its credit balance and the tools it may use. (get_agent_identity, list_capabilities).
You stay in control.
The assistant works as you, never as more than you. Everything it does is something you could do in the editor, and a key can be narrowed to less.
- Scopes: Each key has its own permissions. Read only can look but not change anything; Create videos can import, set up, render and share. Renders need a scope of their own.
- Prices first: A render’s price and your balance can be checked before it starts. A render your credits do not cover is refused, not charged.
- Your plan, your credits: Renders use your credits at exactly the price exporting in the editor charges; importing, projects, replay links and analysis use none. No second price list, no separate balance.
- Safe retries: A render retried with the same idempotency key is never charged or rendered twice.
- Revoke at once: A key stops working the moment you revoke it in Settings → Agents & API keys. Up to 10 keys can be active at a time, and the screen shows when each was last used.
It cannot post to your social accounts, change your account or billing, or delete anything: archiving a project is as far as it goes, and archived projects can be restored.
Which assistants can connect
Any MCP client that connects to remote servers over Streamable HTTP and lets you add an Authorization header. By their makers’ own documentation, these do:
- Claude (Anthropic): Claude Code, with one command. The Claude apps, as a custom connector with a request header, where Anthropic’s request-header beta is open to your account.
- Codex (OpenAI): Codex in the terminal, in your editor or in the ChatGPT desktop app, which share one config.toml. Not yet: ChatGPT on the web signs in to MCP servers with OAuth only, so it cannot connect yet.
- Gemini CLI (Google): Gemini CLI, with one command. Not yet: The Gemini app’s custom apps have no documented way to send an API key, so it cannot connect yet.
- GitHub Copilot (GitHub): Copilot in VS Code, from an MCP configuration file with the key in a header.
- Cursor (Anysphere): Cursor, from its mcp.json with the key in a header.
MCP connects the client, not the model. In Cursor and GitHub Copilot you choose the model — OpenAI’s GPT, Anthropic’s Claude or Google’s Gemini among them — and ChessMotion’s tools are the same whichever you pick.
It signs in with an API key in an Authorization header. Clients that can only sign in with OAuth cannot connect yet. Agent frameworks and MCP client libraries connect the same way: the address https://chessmotion.com/api/mcp and the header Authorization: Bearer with your key. The server offers tools only, and every call is answered in one response.
Set up Codex, Gemini CLI, Copilot, Cursor or the Claude apps
ChessMotion MCP or ChessMotion Agent?
Two ways to have games turned into content without opening the editor. They use the same tools underneath.
- ChessMotion MCP: Your assistant, your instructions. You decide the game, the moment and the look, in a conversation with the assistant you already use. Good for one exact video, for repeating the same recipe, or for working from a script. How to make chess videos with an AI assistant.
- ChessMotion Agent: ChessMotion picks the moments. It reads your games, finds three moments worth posting and writes the posts. No setup and no assistant needed; you approve, edit or reject each one. What ChessMotion Agent does.
In Creator, Creator Live and Club Live.
ChessMotion MCP is included in Creator, Creator Live and Club Live, and the assistant works with everything those plans include: premium templates, Full HD and your Brand Kit. Free and Starter don’t include MCP or API keys. On those plans Settings shows the upgrade instead of the key controls.
Renders use your credits at exactly the price exporting in the editor charges; importing, projects, replay links and analysis use none. Compare plans and prices.
Guides
Frequently asked questions
What is ChessMotion MCP?
It is ChessMotion’s MCP server: a way for Claude and other AI assistants to use your ChessMotion account. The assistant can import games, set up video projects, render MP4s, 9:16 videos and GIFs, and share interactive replay links, all on your plan and with your credits.
What is an MCP server?
MCP, the Model Context Protocol, is an open standard that lets an AI assistant use tools from other services. An MCP server offers those tools; your assistant, the MCP client, calls them when your request needs them.
Which AI assistants can connect?
Any MCP client that connects to remote servers over Streamable HTTP and lets you send an Authorization header. That includes Claude, Codex, Gemini CLI, GitHub Copilot and Cursor, and the Claude apps where Anthropic’s request-header beta is open to your account. Clients that can only sign in with OAuth cannot connect yet.
Does it work with ChatGPT and Gemini?
With OpenAI’s Codex, including Codex in the ChatGPT desktop app, and with Google’s Gemini CLI: both send the key in a header. ChatGPT on the web and the Gemini app offer no way to send an API key to an MCP server, so they cannot connect yet.
Which plans include it, and what does it cost?
It is included in Creator, Creator Live and Club Live, at no extra cost. Free and Starter don’t include MCP or API keys. Connecting, importing games, creating projects, sharing replay links and analysing games use no credits. Renders use your plan’s credits at exactly the editor’s price, and the assistant can check the price before it renders.
Can the assistant spend my credits without asking?
Only if its key has the scope to start renders, and only at the editor’s prices. A render your balance does not cover is refused, not charged. Ask your assistant to quote the price first, and give render permission only to keys you mean to render with. Revoking a key stops it at once.
Can it post to my social media accounts?
No. It makes the video or the replay link and gives it to you; you decide where it goes.
Is my API key safe?
The key is shown once, when you create it, and ChessMotion keeps only a hash of it. Treat it like a password: anyone who has it can act within its scopes. If it leaks, revoke it in Settings and make a new one.
Can it read other people’s games?
It lists recent games only for the Chess.com and Lichess usernames saved in your own settings. Any public game link or PGN you give it can be imported, exactly as in the app.
How is it different from ChessMotion Agent?
ChessMotion Agent works inside ChessMotion: it chooses the moments in your games and drafts three posts for your review. ChessMotion MCP lets your own assistant do what you tell it, step by step. Both use the same tools and the same credits.
What can it make?
MP4 videos in square or 16:9, 9:16 vertical videos for Shorts, Reels and TikTok, animated GIFs, and interactive replay links anyone can open. It uses the templates approved for assistants that your plan includes.
Read next: How to connect Claude to ChessMotion, How to make chess videos with an AI assistant, What the ChessMotion MCP server is and Pricing.