What the ChessMotion MCP server is, and what it can do

An MCP server lets an AI assistant use another service’s tools on your behalf. ChessMotion’s turns your account into tools an assistant such as Claude can call: import a game, set up a video, render it, share a replay. Here is what that means, what it can do and where it stops.

The short version

ChessMotion MCP is a remote MCP server at https://chessmotion.com/api/mcp. Connect an MCP client with an API key from Settings → Agents & API keys, and the assistant can import games, create and set up video projects, render MP4s, 9:16 videos and GIFs, and share interactive replays — on your plan, with your credits, within the permissions you give the key.

What MCP is

MCP, the Model Context Protocol, is an open standard for connecting AI assistants to the tools and data of other services. It has two sides. The MCP client is the assistant you talk to, or the program it runs in. The MCP server belongs to the service and describes a set of tools: what each one is called, what it does and which inputs it takes.

When a request needs one of those tools, the assistant calls it, reads the answer and carries on. You do not write the calls yourself, and the assistant does not need to know anything about the service in advance: the server tells it which tools there are each time it connects.

What ChessMotion’s server offers

Each tool is one thing ChessMotion already does in the app, with the same checks behind it. Together they cover the path from a game to a finished video or a shared replay:

  • Games: your recent Chess.com and Lichess games, from the usernames saved in your settings, and any game from a public link or a PGN. Importing is free.
  • Facts and analysis: what happened in a game, move by move — captures, checks, material swings, how it ended — and, with its own permission, Stockfish analysis to find the moments worth showing, at no charge.
  • Looks: the templates, boards, piece sets, music and Brand Kits your plan can use, with what each template can show and which text it accepts.
  • Projects: a video project from a game, and the editor’s settings for it — the moves to show, orientation, board, pieces, music, text, timed captions and Brand Kit. What the assistant sets is what you see when you open the project in the editor.
  • Renders: the price before anything is charged, then an MP4 in square or 16:9, a 9:16 vertical video or an animated GIF, its progress, and the finished file.
  • Replays: an interactive replay link anyone can open without an account, unlisted or public, and closing it again.

The ChessMotion MCP page lists every tool by name.

How a request becomes a video

Ask for “a 9:16 short of the last ten moves of my latest Lichess win” and a typical assistant will list your recent games, import the one you mean, look at the templates your plan can use, create a project from the game, set the move range and the vertical text, check the price, render it, wait for it to finish and give you the file.

Each of those steps is a separate tool call you can see in your client, and each answer says exactly what happened, including what a render charged. When something does not fit — a template that has no room for the text, a balance that does not cover the render — the tool says why, and the assistant can fix the request or ask you.

Which plans include it, and what it costs

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. Connecting costs nothing extra on the plans that include it. 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.

Prices are not something the assistant has to guess. One tool returns the exact price of a render, the balance and whether it is affordable, without charging anything, so it is natural to ask for a quote first.

What keeps it safe

The assistant signs in with an API key you make in Settings → Agents & API keys. Each key belongs to you and acts only as you: on your plan, with your credits and your projects, never with anyone else’s and never with more than you could do yourself.

  • Scopes narrow each key: Read only can look but change nothing, Create videos can import, set up, render and share. Starting renders, the one thing that spends credits, is a permission of its own.
  • The key is shown once, when you make it, and ChessMotion stores only a hash of it.
  • Revoking a key stops it on its next call. Up to 10 keys can be active at a time, and the screen shows when each was last used.
  • A render retried with the same idempotency key is never charged or rendered twice, and a render your credits do not cover is refused before anything is charged.
  • Each key has its own rate limits, such as five renders a minute.

What it deliberately does not do

  • It does not post to social media. It makes the video or the link and gives it to you.
  • It cannot change your account, your plan or your billing, and it cannot delete anything; archiving a project is as far as it goes, and archived projects can be restored.
  • It signs in with an API key in an Authorization header. Clients that can only sign in with OAuth cannot connect yet.
  • It offers tools only, not MCP prompts or resources, and answers each call in a single response.

MCP, ChessMotion Agent or the editor?

Use the editor when you want to place every arrow and choose every frame yourself. Use ChessMotion Agent when you want ChessMotion to read your games, pick the moments and write the posts for you to review. Use ChessMotion MCP when you already work with an AI assistant and want to describe the video in your own words — or make the same kind of video again and again without opening the app.

To set it up, follow how to connect Claude to ChessMotion. For the requests that work best, read how to make chess videos with an AI assistant.

Rather have ChessMotion pick the moments?

ChessMotion Agent needs no assistant and no instructions. It reads your games, finds 3 moments worth posting, makes the 9:16 videos and drafts the posts, and you approve, edit or reject each one. Free accounts can try it once. See ChessMotion Agent.

Frequently asked questions

Is the ChessMotion MCP server free?

It is included in Creator, Creator Live and Club Live at no extra cost. Free and Starter don’t include MCP or API keys. Importing, projects, replay links and analysis use no credits; renders use your plan’s credits at the editor’s price.

Do I need to write code?

No. You add the server to an MCP client such as Claude Code once, then describe what you want in plain words. Developers can call the same tools from an agent framework or an MCP client library.

Can the assistant see my other ChessMotion data?

Only through the tools its key’s scopes allow, and only your own projects, games, renders and replays. It cannot see payment details or change your account.

Does it work with clients that sign in with OAuth?

Not yet. The server signs in with an API key sent in an Authorization header, so it needs a client that lets you add one.

Sources