Skip to content
MCP server

ConsoleMouse profiles

Read-only helper that writes, validates and previews ConsoleMouse profile files

Pricing
Free
Platforms
API, Web
Runs
Remotely
Version
0.2.0
Listing updated
3 days ago

About ConsoleMouse profiles

ConsoleMouse profiles is a free MCP server for games and play. It runs as a hosted remote server, so there is nothing to install locally.

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.

Install

Run in a terminal

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

Add to Settings → Connectors → Add custom connector

https://mcp.consolemouse.com/mcp
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "profiles": {
      "url": "https://mcp.consolemouse.com/mcp"
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

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

Add to ~/.codeium/windsurf/mcp_config.json

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

Add to your client's MCP settings (most use this shape)

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

Tools this server provides (5)

Taken from the project documentation; the running server may differ.

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.

What it does

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

Pricing

Free

MCP server is free; ConsoleMouse app is a one-time EUR 9.99 on Steam

Prices change. Check consolemouse.com before you buy.

ConsoleMouse profiles 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 to ConsoleMouse profiles

  1. VfxSmith

    MCP server

    Search, generate, refine and export pixel art game effects from Claude Code or Codex

    Not checked yet
    • Remote
    • Freemium
    • Design and media
  2. Born Then

    MCP server

    Free MCP server that rolls random historical births weighted by real demographics

    • 2 tools
    • Remote
    • Free
    • Education and exams
  3. Haze City

    MCP server

    MCP server for agents to look around and build in a shared 3D world

    • 17 tools
    • Remote
    • Open source
    • Games and play
  4. Vectoroids

    MCP server

    A first-person 3D asteroids game with a scanner, playable by humans and agents

    • 6 tools
    • Remote
    • Free
    • Games and play
  5. Vector Abyss

    MCP server

    Play a Tempest-style 3D tube shooter, or let an AI agent play it turn by turn

    • 6 tools
    • Remote
    • Free
    • Knowledge and memory