# MCP server for ConsoleMouse profiles | ConsoleMouse

Public, read-only MCP server that helps Claude write and check ConsoleMouse profiles: endpoint, setup in Claude, tools, import codes and data handling.

Source: https://consolemouse.com/en/developers/mcp/

[ConsoleMouse](https://consolemouse.com/en/support/) / Developers

# ConsoleMouse MCP server

The ConsoleMouse MCP server is a public, read-only helper at https://mcp.consolemouse.com/mcp . It lets Claude and other MCP clients write, check and explain ConsoleMouse profiles. It needs no sign-in.

Updated: 2026-11-09 · [Deutsche Fassung](https://consolemouse.com/de/entwickler/mcp/)

## What the server does

It gives an assistant the ConsoleMouse profile format, a validator, a plain-language preview and an import-code builder.

ConsoleMouse stores every control layout as a profile file. With this server, an assistant can turn a request such as "everything on the left half of the keyboard" into a profile that ConsoleMouse can import.

- No sign-in, no accounts, no storage and no outgoing requests.
- It never talks to a console, a PlayStation service or the ConsoleMouse app.
- You import the result yourself and decide in the app.
## Endpoint and transport

Connect to https://mcp.consolemouse.com/mcp over Streamable HTTP; the server is stateless and needs no authentication.

- Endpoint: https://mcp.consolemouse.com/mcp
- Transport: Streamable HTTP, stateless. One JSON-RPC message per POST, JSON answer, no session ID, no event stream.
- Protocol versions: 2026-07-28, 2025-11-25, 2025-06-18 and 2025-03-26.
- Authentication: none. All tools work on public data.
- Origin header: requests without one are allowed (server to server, MCP Inspector, curl). Requests with one must come from claude.ai, claude.com, chatgpt.com or chat.openai.com; others get HTTP 403.
## Add it to Claude

Add the server in Claude as a custom connector with the URL above and no sign-in, then turn it on in a chat.

- In Claude, open Customize, then Connectors .
- Choose Add, then Add custom connector .
- Enter a name, for example "ConsoleMouse profiles", and the URL https://mcp.consolemouse.com/mcp .
- Set Authentication to No sign-in and leave the request headers empty. Save.
- In a chat, turn the connector on: choose Use on the connector card or switch it on in the chat’s connectors menu.
To remove it, delete the connector in the same settings. Your profiles stay in ConsoleMouse.

## ChatGPT

A ConsoleMouse plugin for ChatGPT is planned and not available yet.

Until then, use the server from Claude or from another MCP client that supports Streamable HTTP without sign-in.

## Tools

The server has five tools, and all of them are read-only: they return documentation or compute an answer from the input and store nothing.
 Tools of the ConsoleMouse MCP server
| Tool | What it does | Main input |
| format_spec | Returns the profile format: a quick reference with the base profiles and the keys they already use, one section of the specification, the full specification or the JSON Schema. | section (default quick_reference ) |
| profile_validate | Checks a profile, an import envelope or an import code against the JSON Schema and every format rule. Returns valid or a list of issues, each with the path to fix. | profile (object, JSON text, envelope or CMP2/CM1 code) |
| profile_describe | Describes a profile in plain language, one sentence per change. | profile, lang (de, en, es, fr, it, pl, pt-BR) |
| profile_import_code | Checks a derived profile and returns the import code, the preview sentences and the import steps. | profile, optional base_profile_id, author_note (up to 500 characters), format ( CMP2 or CM1 ), lang |
| format_examples | Lists the base profiles, example profiles and invalid examples, or returns one file. | optional id, kind |
Every tool has a title and the annotations readOnlyHint: true, destructiveHint: false, idempotentHint: true and openWorldHint: false .

Until 31 December 2026 the old tool names get_format_spec, list_examples, validate_profile, describe_profile and build_import_code keep working as aliases.

## Example prompts

With the connector on, describe the controls you want in plain words; Claude chooses the tools.

- "Make me a ConsoleMouse profile with everything on the left half of the keyboard, and put Square then Circle on the Z key."
- "I can’t hold buttons for long. Change the ConsoleMouse press-once template so Circle also switches on and off with one press."
- "Check this ConsoleMouse import code and tell me in German what it changes: CMP2.…"
## Importing the result

You paste the import code into ConsoleMouse yourself; nothing changes before you check the preview and save.

- CMP2 codes (the default) import in ConsoleMouse 0.5.0 and later: Games > Import profile, paste the code, check the preview. The original profile stays untouched; the change is saved as your own copy.
- ConsoleMouse 0.3.9 to 0.4.x read the older CM1 format. Ask for it, and profile_import_code writes a CM1 code ( format: "CM1" ).
- Macros, press once and the mouse mode move need ConsoleMouse 0.5.0 or later.
- Some online games restrict macros. Check a game’s rules before you use one there.
## Data handling

The server answers from memory and stores nothing; it logs no request or response content and keeps no per-request logs.

- It receives only the tool arguments an assistant sends, usually from Anthropic’s or OpenAI’s servers, not your name, your account or the rest of your chat.
- Workers Logs, invocation logs, traces, Logpush and tail consumers are off. Only aggregate counts remain, such as the number of requests and errors.
- Cloudflare, the host, processes connection data (IP address, time, status) to deliver and protect the service and to enforce the rate limit.
- No cookies, no analytics, and no use of requests to train AI models.
- Full text: [Privacy: AI assistants (ChatGPT and Claude)](https://consolemouse.com/en/privacy/#ai-assistants).
## Limits

Each client IP address may send 300 requests per minute; above that, the server answers HTTP 429.

- Cloudflare counts per location, so a short burst can pass a few dozen extra requests before 429 starts.
- Connector traffic arrives from the providers' shared IP addresses, so all users of one provider share that budget.
- Size limits: 300,000-byte request body, 256 KiB profile, 64 KiB sharing envelope, 90,000-character code, 50 issues per answer, 200 preview sentences.
- Macros stay small: one press plays a fixed sequence of up to 8 steps once, within 5 seconds, with no stick movement, no repeats or rapid fire, no conditions and no PS button.
## Terms, privacy and help

The plugin terms and the privacy notice cover this server, and the plugin help page answers common problems.

- [Terms of use for the ConsoleMouse plugins](https://consolemouse.com/en/plugin-terms/)
- [Privacy: AI assistants (ChatGPT and Claude)](https://consolemouse.com/en/privacy/#ai-assistants)
- [Help with ConsoleMouse in ChatGPT and Claude](https://consolemouse.com/en/support/ai-plugins/)
- Contact: [hello@consolemouse.com](mailto:hello@consolemouse.com), or see [ConsoleMouse support](https://consolemouse.com/en/support/). Security issues: [security@consolemouse.com](mailto:security@consolemouse.com).
- The server is operated by stifler.dev.
- Publisher: [stifler.dev](https://stifler.dev/impressum)