ConsoleMouse profiles
Write and check ConsoleMouse profile files: format, validator, plain-language preview, import code.
Should I use this
Quality & Safety
Based on automated analysis of tool definitions and protocol compliance.
Context Cost
This is the approximate number of tokens consumed each time the server's tools are loaded into a model's context. Higher counts reduce the attention available for other tasks.
Install
One-Click Install
Add this to your `claude_desktop_config.json` file:
{
"mcpServers": {
"profiles": {
"url": "https://mcp.consolemouse.com/mcp"
}
}
}Remote endpoints
https://mcp.consolemouse.com/mcpstreamable-httpWhat it can do
Tool inventory
Tools (5)
🟢format_spec(section)
Returns the ConsoleMouse profile format (profile-v1 1.32.0): a quick reference for writing profiles and macros, one section of the specification (import_code: the CMP2 import code and the older CM1 share code), or the JSON Schema. Read-only; returns published documentation.
Input Schema
{
"type": "object",
"properties": {
"section": {
"type": "string",
"enum": [
"quick_reference",
"intro",
"overview",
"macros",
"press_once",
"mouse_move",
"preview",
"versioning",
"import_code",
"keys_per_situation",
"known_limits",
"full",
"schema"
],
"default": "quick_reference",
"description": "quick_reference (default: everything needed to write a profile, with the base profiles and their bound keys), a specification section, full, or schema (JSON Schema)."
}
},
"additionalProperties": false
}🟢format_examples(id, kind)
Lists the published base profiles (accessibility templates), example profiles and invalid examples with their expected validator message; with an id, returns that file. Read-only.
Input Schema
{
"type": "object",
"properties": {
"id": {
"type": "string",
"maxLength": 64,
"description": "Return this example file (id from the list)."
},
"kind": {
"type": "string",
"enum": [
"all",
"templates",
"profiles",
"invalid"
],
"default": "all"
}
},
"additionalProperties": false
}🟢profile_validate(profile)
Checks a ConsoleMouse profile (full or derived), an import envelope or an import code (CMP2, or the older CM1) against the JSON Schema and every format rule, including the macro limits. Returns valid or a list of issues with the path to fix. Read-only; nothing is stored.
Input Schema
{
"type": "object",
"properties": {
"profile": {
"type": [
"object",
"string"
],
"description": "The profile as a JSON object, as JSON text, an import envelope, or an import code (CMP2., or the older CM1.). Usually a derived profile (origin \"derived\", base_profile_id, patch)."
}
},
"required": [
"profile"
],
"additionalProperties": false
}🟢profile_describe(profile, lang)
Returns a plain-language preview of a valid ConsoleMouse profile: for a derived profile one sentence per change against its base (keys, macros, press once, mouse movement), for a full profile one sentence per key. Languages: de, en, es, fr, it, pl, pt-BR. Read-only.
Input Schema
{
"type": "object",
"properties": {
"profile": {
"type": [
"object",
"string"
],
"description": "The profile as a JSON object, as JSON text, an import envelope, or an import code (CMP2., or the older CM1.). Usually a derived profile (origin \"derived\", base_profile_id, patch)."
},
"lang": {
"type": "string",
"enum": [
"de",
"en",
"es",
"fr",
"it",
"pl",
"pt-BR"
],
"default": "en",
"description": "Language of the sentences."
}
},
"required": [
"profile"
],
"additionalProperties": false
}🟢profile_import_code(profile, base_profile_id, author_note, format, lang)
Checks a derived ConsoleMouse profile and returns an import code (CMP2) the person pastes into ConsoleMouse under Games > Import profile or in the AI Workshop (Import code), with the plain-language preview and the import steps. A full profile is accepted when base_profile_id names its base. Use format CM1 only when the person has an older ConsoleMouse (0.3.9 to 0.4.x). Read-only: the code is computed and returned, nothing is stored or sent anywhere.
Input Schema
{
"type": "object",
"properties": {
"profile": {
"type": [
"object",
"string"
],
"description": "The profile as a JSON object, as JSON text, an import envelope, or an import code (CMP2., or the older CM1.). Usually a derived profile (origin \"derived\", base_profile_id, patch)."
},
"base_profile_id": {
"type": "string",
"enum": [
"accessibility-left-hand-keyboard-ps5",
"accessibility-right-hand-mouse-ps5",
"accessibility-press-once-ps5"
],
"description": "Only for a full profile: the base it was made from."
},
"author_note": {
"type": "string",
"maxLength": 500,
"description": "Optional note shown with the import preview. Plain text (no control characters); describe the controls, nothing personal."
},
"format": {
"type": "string",
"enum": [
"CMP2",
"CM1"
],
"default": "CMP2",
"description": "CMP2 (default, current ConsoleMouse). CM1 only for ConsoleMouse 0.3.9 to 0.4.x, which need the exact base version."
},
"lang": {
"type": "string",
"enum": [
"de",
"en",
"es",
"fr",
"it",
"pl",
"pt-BR"
],
"default": "en",
"description": "Language of the preview and the import steps."
}
},
"required": [
"profile"
],
"additionalProperties": false
}Community
Evidence