---
title: MCP troubleshooting
description: Fixes for common problems connecting to the Elroot Dot Matrix MCP server.
---

# MCP troubleshooting

## The art in my project doesn't match the art page

Check two things:

1. **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](/opensource/dotmatrix/docs/mcp-connect), check that your app lists the tools `list_categories`, `search_arts` and `get_art`, and paste the prompt again.
2. **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](/opensource/dotmatrix/docs/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](/opensource/dotmatrix/docs/mcp-connect)), 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.
