# ConsoleMouse profiles

> ConsoleMouse profiles is a free MCP server for games and play. Read-only helper that writes, validates and previews ConsoleMouse profile files. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Pricing:** Free
- **Platforms:** API, Web
- **Website:** https://consolemouse.com/en/developers/mcp/
- **MCP Registry name:** com.consolemouse/profiles
- **Categories:** games and play
- **Listing updated:** 2026-11-14

## About

ConsoleMouse stores every control layout as a profile file, and this server gives an assistant the format spec to write them. A request like "everything on the left half of the keyboard, and Square then Circle on the Z key" can become a profile the app imports, after the assistant checks it with the validator.

The server is public and stateless at mcp.consolemouse.com, needs no sign-in, and stores nothing. It never contacts a console, a PlayStation service or the ConsoleMouse app; you paste the resulting import code yourself and approve it in a preview. CMP2 codes import into ConsoleMouse 0.5.0 and later, and the older CM1 format covers 0.3.9 to 0.4.x.

Limits are stated plainly: 300 requests per minute per IP, a 256 KiB profile size and macros of at most 8 steps within 5 seconds, with no repeats or rapid fire. Descriptions can be produced in German, English, Spanish, French, Italian, Polish and Brazilian Portuguese. The site notes that some online games restrict macros.

## Features

- **Format specification:** Returns a quick reference, one section, the full spec or the JSON Schema.
- **Profile validator:** Checks profiles, envelopes or import codes and reports each issue with a path.
- **Plain-language preview:** Describes each change in a profile as one sentence, in seven languages.
- **Import code builder:** Produces CMP2 or CM1 import codes with preview and steps.
- **No data stored:** No sign-in, no storage and no request content logging.

## Good for

- Turn a plain-language control layout into an importable profile
- Check an import code before pasting it into the app
- Adapt a press-once template for accessibility needs
- Have a profile explained in German or another supported language

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http profiles https://mcp.consolemouse.com/mcp
```

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://mcp.consolemouse.com/mcp
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "profiles": {
      "url": "https://mcp.consolemouse.com/mcp"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "profiles": {
      "type": "http",
      "url": "https://mcp.consolemouse.com/mcp"
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "profiles": {
      "serverUrl": "https://mcp.consolemouse.com/mcp"
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "profiles": {
      "type": "http",
      "url": "https://mcp.consolemouse.com/mcp"
    }
  }
}
```

## Tools

- `format_spec`: Returns the profile format: quick reference, a section, the full spec or the JSON Schema.
- `profile_validate`: Checks a profile, envelope or import code against the schema and format rules.
- `profile_describe`: Describes a profile in plain language, one sentence per change.
- `profile_import_code`: Checks a derived profile and returns the import code, preview and steps.
- `format_examples`: Lists base, example and invalid profiles or returns one file.

## FAQ

### Does it need an account?

No. It is a public, read-only server with no authentication.

### Can it change my ConsoleMouse settings?

No. You import the code yourself and review the preview first.

### Which app versions are supported?

CMP2 imports in 0.5.0 and later; CM1 covers 0.3.9 to 0.4.x.

### Is there a rate limit?

Yes, 300 requests per minute per client IP.

### Is ConsoleMouse profiles free?

Yes. ConsoleMouse profiles is free to use.

### How do I add ConsoleMouse profiles to Claude Code?

Run this command in your terminal: claude mcp add --transport http profiles https://mcp.consolemouse.com/mcp

### What are the best alternatives to ConsoleMouse profiles?

The closest alternatives to ConsoleMouse profiles are AvatarSay — Fictional Character & Talking Video MCP, VfxSmith, Born Then, Haze City and Vectoroids.

## Alternatives

- [AvatarSay — Fictional Character & Talking Video MCP](https://ai-powered.com/mcp/avatarsay-fictional-character-and-talking-video-mcp): AvatarSay — Fictional Character & Talking Video MCP is a freemium MCP server for design and media.
- [VfxSmith](https://ai-powered.com/mcp/vfxsmith): VfxSmith is a freemium MCP server for design and media.
- [Born Then](https://ai-powered.com/mcp/born-then): Born Then is a free MCP server for education and exams.
- [Haze City](https://ai-powered.com/mcp/haze-city): Haze City is an open-source MCP server for games and play.
- [Vectoroids](https://ai-powered.com/mcp/vectoroids): Vectoroids is a free MCP server for games and play.
- [Vector Abyss](https://ai-powered.com/mcp/vector-abyss): Vector Abyss is a free MCP server for knowledge and memory.
- [Vector Alienspace](https://ai-powered.com/mcp/vector-alienspace): Vector Alienspace is a free MCP server for knowledge and memory.
- [Vector Defence](https://ai-powered.com/mcp/vector-defence): Vector Defence is a free MCP server for knowledge and memory.

---
Source: https://ai-powered.com/mcp/consolemouse-profiles
