get_session
Get Keyboardia session
Read the current tempo and compact track patterns from an existing Keyboardia session.
session_idrequired
io.github.adewalePublished by GitHub account adewalev1.1.0Updated Oct 24, 2026
Create, co-edit, analyze, publish, and export collaborative step-sequencer sessions through MCP.
A remote MCP server for Keyboardia, a collaborative step sequencer, letting an assistant create, edit, analyze, publish and export music sessions.
Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.
Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.
Read https://sourceweft.com/mcp/io.github.adewale%2Fkeyboardia/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.Add this to your client's mcpServers config.
{
"mcpServers": {
"keyboardia": {
"type": "http",
"url": "https://keyboardia.dev/mcp"
}
}
}A multiplayer step sequencer with polyrhythmic patterns, built for real-time collaboration.
Configure your MCP client with:
To co-edit music you already have, open a session and give the agent the UUID
from its https://keyboardia.dev/s/{session_id} URL. Agents can read the
current rhythm, add a track, assign specific steps, and change tempo. Their
edits use the same live session as connected browsers, and published sessions
stay read-only.
Agents can also start from nothing: create a new session and hand back its link, remix a published session into an editable copy without touching the original, publish the current result as an immutable snapshot when you ask, and export the session as a MIDI file for a DAW.
They can explain music too — ask what key a session is in, how its rhythms sit against each other, or what chord a moment forms, and the answer comes from the same music-theory module the Key Assistant uses, with its uncertainty stated rather than hidden.
See the stateless MCP rhythm-slice specification for the exact tool contract and current limitations. Directory maintainers can use the canonical MCP listing record, and hosted data handling is described in the MCP privacy notice.
Add ?debug=1 to the URL to enable debug features:
See docs/DEVELOPMENT-TOOLS.md for comprehensive debugging documentation.
synth.ts) - Native Web Audio oscillators, 40+ presetstoneSynths.ts) - Tone.js FM/AM/Membrane synthsadvancedSynth.ts) - Dual-oscillator with filter envelope and LFOsampled-instrument.ts) - Sample-based playback (piano)Bundled instrument samples are third-party content with their own licenses (CC0, public domain, and similar free-use terms), documented in app/public/instruments/LICENSE.md.
Source: README.md at commit 869d3f5
Get Keyboardia session
Read the current tempo and compact track patterns from an existing Keyboardia session.
session_idrequiredEdit Keyboardia session
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.
editrequiredsession_idrequiredCreate Keyboardia session
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.
nametempoidempotency_keyrequiredRemix Keyboardia session
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.
session_idrequiredPublish Keyboardia session
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.
session_idrequiredExport Keyboardia session as MIDI
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.
session_idrequiredAnalyze Keyboardia session
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.
session_idrequired75% of the applicable checks met
How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.
Keep the endpoint answering the MCP handshake; SourceWeft probes it every 30 days.
https://keyboardia.dev/mcpcd app
# Install dependenciesnpm install
# Start development servernpm run dev
# Run testsnpm run test:all
# Build for productionnpm run buildapp/├── src/│ ├── audio/ # Audio engine, synths, effects, scheduling│ ├── components/ # React UI components│ ├── hooks/ # React hooks (useSession, useMultiplayer, etc.)│ ├── state/ # State management (grid reducer)│ ├── sync/ # Multiplayer synchronization│ ├── worker/ # Cloudflare Worker (Durable Objects, API routes)│ ├── utils/ # Logging, debugging, utilities│ └── debug/ # Debug overlay and context├── e2e/ # End-to-end tests (Playwright)├── test/ # Integration tests└── scripts/ # Development and debugging scriptscd appnpm run test:unit # Unit tests (vitest, fast product lane)npm run test:audio-render # Offline audio renders (native Web Audio)npm run test:verification-tooling # Tests of the verification tooling itselfnpm run test:integration # Integration tests (Cloudflare Workers)npm run test:all # All of the abovenpm run analyze:bugs # Static bug pattern analysisSource (Oscillator/Sample) → Track Gain (per-track volume) → Master Gain → Effects Chain (Tone.js: reverb → delay → chorus → distortion) → Limiter → Compressor → DestinationClient A ←→ Durable Object ←→ Client B ↓ DO Storage (immediate) ↓ KV Storage (on disconnect)