Docs / MCP
MCP troubleshooting
The art in my project doesn't match the art page
Check two things:
- Did the assistant use the server? The file it added should start with a comment naming the art and
Elroot Dot Matrix, followed by the MIT licence. If not, it drew its own version, usually because the server isn't connected. Connect it, check that your app lists the toolslist_categories,search_artsandget_art, and paste the prompt again. - Is the box big enough? An art needs about 96 px on its shorter side: an icon 96 px wide, a card 154 px, a banner 250 px, a background 171 px. In a smaller box the art loses its detail. See Sizing.
Settings you changed on the art page (colour, speed, dots) travel in its link: copy the prompt after changing them.
The assistant says it can't find the tools
The server isn't connected in this app, or the app was started before you added it. Add it (how), restart the app or start a new chat, and check the tools are listed.
The app only starts local servers
Some apps can only run MCP servers as local programs. They need a bridge that connects a local program to a remote server; check your app's documentation for remote or HTTP servers first.
403 Forbidden
The server refuses requests sent from a web page on another site (a browser sends that site's address as Origin). Call it from your assistant or from your own server instead.
429 Too many requests
Requests are rate-limited. Wait a minute and try again.
"Unsupported protocol version"
The answer lists the versions the server speaks: 2026-07-28, 2025-11-25, 2025-06-18, 2025-03-26 and 2024-11-05. Update your app, or set it to one of these.
"Header mismatch"
With revision 2026-07-28, the MCP-Protocol-Version, Mcp-Method and Mcp-Name headers must match the request body. Apps that follow the specification send them for you.
"This is a Pro art"
Pro arts are not handed out as code yet. The answer lists the free arts in the same category; ask for one of those, or search with access: "free". An assistant shouldn't redraw a Pro art by hand.