Koskamo

Keyboardia MCP

Keyboardia is a multiplayer step sequencer that allows AI agents to co-edit, create, remix, publish, export, and analyze collaborative music sessions via a stateless MCP interface. Agents can read rhythms, add tracks, assign steps, change tempo, and explain music theory aspects of the session.

Endpoint and access

No sign-in to connect and list tools. Individual tools may still need a vendor account, credentials, or permissions; check the documented prerequisites.

Keyboardia MCP logo, by adewaleCommunity listingStreamable HTTPNo sign-inEndpoint checked 2026-11-06Published by adewale
MCP endpoint (Streamable HTTP)
https://keyboardia.dev/mcp
Vendor documentation

What its tools do

7 tools, grouped by the hints the server advertises. Hints are self-declared, not verified behavior.

Read-only (3)

Can change data (4)

7 of 7 have a description · 7 of 7 declare behavior hints · 7 of 7 with parameters document them all

Checks and signals

Each line is separate evidence, not a trust score.

  • Passed Endpoint answered the live check ·
  • Availability 1 of 1 checks passed in 30 days

What you can do with it

  • Co-edit and create music sessions
  • Export sessions as MIDI files
  • Analyze music theory and rhythms
  • Remix published sessions

Source and maintenance

Community listingRegistry 1.1.0
mcp-registry: io.github.adewale/keyboardia@1.1.0Source repositoryProject website
Maintenance checked

Protocol and capabilities

Server
keyboardia 1.1.0
MCP protocol negotiated in check
2025-11-25
Tools
7 advertised
Resources
Not advertised
Resource templates
Not advertised
Prompts
Not advertised
Server-advertised capabilities
{
  "tools": {
    "listChanged": true
  }
}

Server-provided instructions

Untrusted server output shown for inspection. It is not Koskamo guidance and is excluded from knowledge search.

Read an existing session with get_session before editing it. After every edit_session attempt, call get_session next for the same session before another edit or a final answer; the compact edit_session result is not verification. Step indexes are zero-based; preserve every track and step the user did not ask to change. For add_track, generate a stable collision-resistant track_id ending in at least eight hexadecimal characters and reuse it on retry. For set_steps, set_track_instrument, and set_track_pan, use a track_id returned by get_session. Only publish when the user explicitly asks. A session UUID grants the same access as its share URL, so do not expose it unnecessarily.

Tools

7 advertised

get_session — Get Keyboardia session
Advertised by the server during the last successful anonymous check.
Advertised read-only

Read the current tempo and compact track patterns from an existing Keyboardia session.

get_session input schema
{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "session_id"
  ],
  "properties": {
    "session_id": {
      "type": "string",
      "format": "uuid",
      "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
      "description": "The UUID after /s/ in a Keyboardia share URL. Pass only the UUID, not the full URL."
    }
  },
  "additionalProperties": false
}
get_session annotations
{
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}
edit_session — Edit Keyboardia session
Advertised by the server during the last successful anonymous check.
Advertised destructive

Make one narrow, retry-safe edit to an existing collaborative session. After every attempt, the next Keyboardia call must be get_session for the same session. A successful call includes a backwards-compatible compact snapshot plus an acknowledgement. That snapshot is not authoritative verification; do not make another edit or finish from it. Read with get_session next. Supported operations: add_track, set_track_instrument, set_track_pan, set_steps, and set_tempo. set_steps changes only the named steps; it never replaces a track or session. set_track_instrument replaces only a track's sound source, keeping its pattern, mix, timing, and custom name.

edit_session input schema
{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "session_id",
    "edit"
  ],
  "properties": {
    "edit": {
      "oneOf": [
        {
          "type": "object",
          "required": [
            "operation",
            "track_id",
            "sample_id"
          ],
          "properties": {
            "name": {
              "type": "string",
              "maxLength": 32,
              "minLength": 1,
              "description": "Optional display name. The instrument name is used when omitted."
            },
            "track_id": {
              "type": "string",
              "pattern": "^(?=.{10,64}$)[A-Za-z0-9][A-Za-z0-9._-]*-[0-9a-fA-F]{8,32}$",
              "description": "Generate a fresh collision-resistant ID that ends with at least eight hexadecimal characters, such as agent-kick-a7f3c29d. Generate it once and reuse it on retries."
            },
            "operation": {
              "type": "string",
              "const": "add_track"
            },
            "sample_id": {
              "enum": [
                "advanced:acid-bass",
                "advanced:sub-bass",
                "advanced:supersaw",
                "advanced:thick-lead",
                "advanced:tremolo-strings",
                "advanced:vibrato-lead",
                "advanced:warm-pad",
                "advanced:wobble-bass",
                "bass",
                "cabasa",
                "chord",
                "clap",
                "clave",
                "conga",
                "cowbell",
                "hihat",
                "kick",
                "lead",
                "noise",
                "openhat",
                "pad",
                "pluck",
                "rim",
                "sampled:808-clap",
                "sampled:808-hihat-closed",
                "sampled:808-hihat-open",
                "sampled:808-kick",
                "sampled:808-snare",
                "sampled:acoustic-crash",
                "sampled:acoustic-guitar",
                "sampled:acoustic-hihat-closed",
                "sampled:acoustic-hihat-open",
                "sampled:acoustic-kick",
                "sampled:acoustic-ride",
                "sampled:acoustic-snare",
                "sampled:alto-sax",
                "sampled:brushes-snare",
                "sampled:clean-guitar",
                "sampled:finger-bass",
                "sampled:french-horn",
                "sampled:hammond-organ",
                "sampled:kalimba",
                "sampled:marimba",
                "sampled:piano",
                "sampled:slap-bass",
                "sampled:steel-drums",
                "sampled:string-section",
                "sampled:vibraphone",
                "sampled:vinyl-crackle",
                "shaker",
                "snare",
                "subbass",
                "synth:acid",
                "synth:bass",
                "synth:bell",
                "synth:brass",
                "synth:clavinet",
                "synth:discobass",
                "synth:dreampop",
                "synth:epiano",
                "synth:evolving",
                "synth:funkbass",
                "synth:glass",
                "synth:growl",
                "synth:hoover",
                "synth:hypersaw",
                "synth:jangle",
                "synth:lead",
                "synth:organ",
                "synth:organphase",
                "synth:pad",
                "synth:pluck",
                "synth:reese",
                "synth:rhodes",
                "synth:shimmer",
                "synth:stab",
                "synth:strings",
                "synth:sub",
                "synth:supersaw",
                "synth:sweep",
                "synth:vibes",
                "synth:warmpad",
                "synth:wobble",
                "synth:wurlitzer",
                "tambourine",
                "tom",
                "tone:am-bell",
                "tone:am-tremolo",
                "tone:duo-lead",
                "tone:fm-bass",
                "tone:fm-bell",
                "tone:fm-epiano",
                "tone:membrane-kick",
                "tone:membrane-tom",
                "tone:metal-cymbal",
                "tone:metal-hihat",
                "tone:pluck-string",
                "woodblock",
                "zap"
              ],
              "type": "string",
              "description": "The canonical Keyboardia instrument ID. Use one of the enumerated values exactly."
            }
          },
          "description": "Add one track. Retrying the same track_id and definition is a no-op; a conflicting reuse is rejected.",
          "additionalProperties": false
        },
        {
          "type": "object",
          "required": [
            "operation",
            "track_id",
            "sample_id"
          ],
          "properties": {
            "track_id": {
              "type": "string",
              "pattern": "^[A-Za-z0-9][A-Za-z0-9._-]{0,63}$",
              "description": "For add_track, choose a stable unique ID and reuse it on retries. For set_steps, set_track_instrument, or set_track_pan, copy an existing track_id from get_session."
            },
            "operation": {
              "type": "string",
              "const": "set_track_instrument"
            },
            "sample_id": {
              "enum": [
                "advanced:acid-bass",
                "advanced:sub-bass",
                "advanced:supersaw",
                "advanced:thick-lead",
                "advanced:tremolo-strings",
                "advanced:vibrato-lead",
                "advanced:warm-pad",
                "advanced:wobble-bass",
                "bass",
                "cabasa",
                "chord",
                "clap",
                "clave",
                "conga",
                "cowbell",
                "hihat",
                "kick",
                "lead",
                "noise",
                "openhat",
                "pad",
                "pluck",
                "rim",
                "sampled:808-clap",
                "sampled:808-hihat-closed",
                "sampled:808-hihat-open",
                "sampled:808-kick",
                "sampled:808-snare",
                "sampled:acoustic-crash",
                "sampled:acoustic-guitar",
                "sampled:acoustic-hihat-closed",
                "sampled:acoustic-hihat-open",
                "sampled:acoustic-kick",
                "sampled:acoustic-ride",
                "sampled:acoustic-snare",
                "sampled:alto-sax",
                "sampled:brushes-snare",
                "sampled:clean-guitar",
                "sampled:finger-bass",
                "sampled:french-horn",
                "sampled:hammond-organ",
                "sampled:kalimba",
                "sampled:marimba",
                "sampled:piano",
                "sampled:slap-bass",
                "sampled:steel-drums",
                "sampled:string-section",
                "sampled:vibraphone",
                "sampled:vinyl-crackle",
                "shaker",
                "snare",
                "subbass",
                "synth:acid",
                "synth:bass",
                "synth:bell",
                "synth:brass",
                "synth:clavinet",
                "synth:discobass",
                "synth:dreampop",
                "synth:epiano",
                "synth:evolving",
                "synth:funkbass",
                "synth:glass",
                "synth:growl",
                "synth:hoover",
                "synth:hypersaw",
                "synth:jangle",
                "synth:lead",
                "synth:organ",
                "synth:organphase",
                "synth:pad",
                "synth:pluck",
                "synth:reese",
                "synth:rhodes",
                "synth:shimmer",
                "synth:stab",
                "synth:strings",
                "synth:sub",
                "synth:supersaw",
                "synth:sweep",
                "synth:vibes",
                "synth:warmpad",
                "synth:wobble",
                "synth:wurlitzer",
                "tambourine",
                "tom",
                "tone:am-bell",
                "tone:am-tremolo",
                "tone:duo-lead",
                "tone:fm-bass",
                "tone:fm-bell",
                "tone:fm-epiano",
                "tone:membrane-kick",
                "tone:membrane-tom",
                "tone:metal-cymbal",
                "tone:metal-hihat",
                "tone:pluck-string",
                "woodblock",
                "zap"
              ],
              "type": "string",
              "description": "The canonical Keyboardia instrument ID. Use one of the enumerated values exactly."
            }
          },
          "description": "Replace only an existing track's sound source while preserving its name, pattern, mix, and timing.",
          "additionalProperties": false
        },
        {
          "type": "object",
          "required": [
            "operation",
            "track_id",
            "pan"
          ],
          "properties": {
            "pan": {
              "type": "number",
              "maximum": 1,
              "minimum": -1,
              "description": "Normalized equal-power stereo position: -1 left, 0 center, 1 right."
            },
            "track_id": {
              "type": "string",
              "pattern": "^[A-Za-z0-9][A-Za-z0-9._-]{0,63}$",
              "description": "For add_track, choose a stable unique ID and reuse it on retries. For set_steps, set_track_instrument, or set_track_pan, copy an existing track_id from get_session."
            },
            "operation": {
              "type": "string",
              "const": "set_track_pan"
            }
          },
          "description": "Set one existing track's normalized stereo position without changing its notes or level.",
          "additionalProperties": false
        },
        {
          "type": "object",
          "required": [
            "operation",
            "track_id",
            "changes"
          ],
          "properties": {
            "changes": {
              "type": "array",
              "items": {
                "type": "object",
                "required": [
                  "step",
                  "value"
                ],
                "properties": {
                  "step": {
                    "type": "integer",
                    "maximum": 127,
                    "minimum": 0,
                    "description": "Zero-based step index. It must be within this track's current step_count."
                  },
                  "value": {
                    "type": "boolean",
                    "description": "true activates the step; false clears it."
                  }
                },
                "additionalProperties": false
              },
              "maxItems": 128,
              "minItems": 1,
              "description": "Assignments for named steps only. Every unmentioned step is preserved."
            },
            "track_id": {
              "type": "string",
              "pattern": "^[A-Za-z0-9][A-Za-z0-9._-]{0,63}$",
              "description": "For add_track, choose a stable unique ID and reuse it on retries. For set_steps, set_track_instrument, or set_track_pan, copy an existing track_id from get_session."
            },
            "operation": {
              "type": "string",
              "const": "set_steps"
            }
          },
          "description": "Change only the listed steps on an existing track. Read get_session first to obtain its track_id and step_count.",
          "additionalProperties": false
        },
        {
          "type": "object",
          "required": [
            "operation",
            "tempo"
          ],
          "properties": {
            "tempo": {
              "type": "number",
              "maximum": 180,
              "minimum": 60,
              "description": "Session tempo in beats per minute (60-180)."
            },
            "operation": {
              "type": "string",
              "const": "set_tempo"
            }
          },
          "description": "Set the session-wide tempo without changing any track.",
          "additionalProperties": false
        }
      ],
      "description": "Exactly one narrow session edit."
    },
    "session_id": {
      "type": "string",
      "format": "uuid",
      "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
      "description": "The UUID after /s/ in a Keyboardia share URL. Pass only the UUID, not the full URL."
    }
  },
  "description": "The target session and one retry-safe edit to apply.",
  "additionalProperties": false
}
edit_session annotations
{
  "readOnlyHint": false,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": true
}
create_session — Create Keyboardia session
Advertised by the server during the last successful anonymous check.

Create a new editable Keyboardia session with the normal defaults and return its shareable URL. The session starts with no tracks; use edit_session to add them. Pass the same idempotency_key when retrying so an uncertain attempt cannot leave duplicate sessions behind.

create_session input schema
{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "idempotency_key"
  ],
  "properties": {
    "name": {
      "type": "string",
      "maxLength": 100,
      "minLength": 1,
      "description": "Optional display name for the new session."
    },
    "tempo": {
      "type": "number",
      "maximum": 180,
      "minimum": 60,
      "description": "Starting tempo in BPM. Defaults to Keyboardia's own default."
    },
    "idempotency_key": {
      "type": "string",
      "format": "uuid",
      "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
      "description": "A UUID you generate for this creation attempt. Reusing it returns the session the first attempt created instead of making another one."
    }
  },
  "additionalProperties": false
}
create_session annotations
{
  "readOnlyHint": false,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}
remix_session — Remix Keyboardia session
Advertised by the server during the last successful anonymous check.

Copy an existing session — published or editable — into a new editable session that records the original as its source. The source is never modified, so this is how to continue from published work.

remix_session input schema
{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "session_id"
  ],
  "properties": {
    "session_id": {
      "type": "string",
      "format": "uuid",
      "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
      "description": "The UUID after /s/ in a Keyboardia share URL. Pass only the UUID, not the full URL."
    }
  },
  "additionalProperties": false
}
remix_session annotations
{
  "readOnlyHint": false,
  "openWorldHint": false,
  "idempotentHint": false,
  "destructiveHint": false
}
publish_session — Publish Keyboardia session
Advertised by the server during the last successful anonymous check.
Open-world

Freeze the current music into a new immutable session and return its URL. The source session stays editable at its own URL. Only call this when someone explicitly asks to publish; it is never a side effect of editing or exporting.

publish_session input schema
{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "session_id"
  ],
  "properties": {
    "session_id": {
      "type": "string",
      "format": "uuid",
      "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
      "description": "The UUID after /s/ in a Keyboardia share URL. Pass only the UUID, not the full URL."
    }
  },
  "additionalProperties": false
}
publish_session annotations
{
  "readOnlyHint": false,
  "openWorldHint": true,
  "idempotentHint": false,
  "destructiveHint": false
}
export_midi — Export Keyboardia session as MIDI
Advertised by the server during the last successful anonymous check.
Advertised read-only

Export the session as a base64-encoded Standard MIDI File, matching what Keyboardia's own Export MIDI produces for the same music. The session is not modified. The result lists any session features a MIDI file cannot carry rather than approximating them silently.

export_midi input schema
{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "session_id"
  ],
  "properties": {
    "session_id": {
      "type": "string",
      "format": "uuid",
      "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
      "description": "The UUID after /s/ in a Keyboardia share URL. Pass only the UUID, not the full URL."
    }
  },
  "additionalProperties": false
}
export_midi annotations
{
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}
analyze_session — Analyze Keyboardia session
Advertised by the server during the last successful anonymous check.
Advertised read-only

Describe what is happening musically in a session — rhythm, pitch content, inferred key, and chords — without changing anything. Use this to explain music rather than to edit it. Results come from the same music-theory module the browser's Key Assistant and Chromatic Grid use, and report where the analysis is uncertain instead of guessing.

analyze_session input schema
{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "session_id"
  ],
  "properties": {
    "session_id": {
      "type": "string",
      "format": "uuid",
      "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
      "description": "The UUID after /s/ in a Keyboardia share URL. Pass only the UUID, not the full URL."
    }
  },
  "additionalProperties": false
}
analyze_session annotations
{
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}

Prompts

Not advertised

No prompt definitions available.

Resources

Not advertised

No resource definitions available.

90-day uptime

A lightweight connection check about every six hours, sampled on hosts with many listings. It shows the server answered, not that its tools work.

Too few checks for a percentage yet (2 of 2 answered).

  1. 2026-11-06: 1 of 1 checks answered
  2. 2026-11-07: 1 of 1 checks answered

30-day availability

Aggregated from read-only remote checks; this is not a tool-execution or security guarantee.

Successful checks
1 of 1 (100%)
Average latency
336 ms
95th percentile latency
336 ms

Maintenance history

Public check and source-refresh events. Editorial and ownership records remain private.

  • · probe · passed · 336 ms · metadata changed · 7 tool(s)

Connect from your client

Each snippet registers the same endpoint; pick the client you use.

This server is operated by the named third party. Listing and endpoint checks are not an endorsement or a security audit. Review the operator's permissions, terms, and data handling before connecting. How listings are checked and corrected.

Claude Code

Run this once in a terminal. It registers the remote server. Use --scope project to write .mcp.json for the repo.
Claude Code configuration
claude mcp add --transport http keyboardia-mcp https://keyboardia.dev/mcp

Codex

Run this once. Codex stores MCP servers in ~/.codex/config.toml (or .codex/config.toml in a trusted project).
Codex configuration
codex mcp add keyboardia-mcp --url https://keyboardia.dev/mcp

Cursor

Merge this server into .cursor/mcp.json in your project, then enable keyboardia-mcp in your MCP settings.
Cursor configuration
{
  "mcpServers": {
    "keyboardia-mcp": {
      "url": "https://keyboardia.dev/mcp"
    }
  }
}

Cline

Merge this into cline_mcp_settings.json (Cline → MCP Servers → Configure).
Cline configuration
{
  "mcpServers": {
    "keyboardia-mcp": {
      "type": "streamableHttp",
      "url": "https://keyboardia.dev/mcp",
      "disabled": false
    }
  }
}

VS Code

Merge this server into .vscode/mcp.json. Use MCP: List Servers to start keyboardia-mcp and inspect its tools.
VS Code configuration
{
  "servers": {
    "keyboardia-mcp": {
      "type": "http",
      "url": "https://keyboardia.dev/mcp"
    }
  }
}

Gemini CLI

Run this once. It writes .gemini/settings.json in the current project; pass --scope user for ~/.gemini/settings.json.
Gemini CLI configuration
gemini mcp add --transport http keyboardia-mcp https://keyboardia.dev/mcp

Claude Desktop

Open Claude Settings > Connectors > Add custom connector, enter this server URL and enable it for the conversation. This is a manual remote-connector handoff, not a desktop JSON configuration.
Claude Desktop configuration
https://keyboardia.dev/mcp

Windsurf

Merge this into ~/.codeium/windsurf/mcp_config.json, then refresh MCP in Cascade. Windsurf remote servers use serverUrl, not url.
Windsurf configuration
{
  "mcpServers": {
    "keyboardia-mcp": {
      "serverUrl": "https://keyboardia.dev/mcp"
    }
  }
}

Let your agent find its tools

Find servers like Keyboardia MCP from your agent. Add Koskamo once to search the index for endpoints, access requirements, and client setup. Public discovery needs no key.

Connect Koskamo Explore workflows
See all 5,557