Ikenga iyke (control bridge)
Bridges Claude Code or any MCP client to a running Ikenga desktop app via its localhost iyke control API. Exposes 30+ tools mirroring the iyke CLI: navigate panes, split layouts, switch sidebar modes, capture DOM snapshots with Playwright-style refs, take screenshots, click elements, type into fields, read console logs and network traces, manage projects. Reads control.json from the app's local data directory for the bearer token and port, so there's no manual configuration. If you're building agents that need to observe or drive a live Ikenga workspace programmatically, this turns the entire shell surface into callable functions. Works over stdio, localhost only, no external network.
- tools
- 25
- transport
- STDIO
- last updated
- May 10, 2026
Tools
25 toolsPublic tool metadata for what this MCP can expose to an agent.
iyke_stateShow current sidebar mode + focused pane's route + full pane tree.
Show current sidebar mode + focused pane's route + full pane tree.
No parameter schema in public metadata yet.
iyke_goNavigate the focused pane to a route path.
Navigate the focused pane to a route path.
No parameter schema in public metadata yet.
iyke_modeSwitch sidebar activity mode.
Switch sidebar activity mode.
No parameter schema in public metadata yet.
iyke_openOpen a new tab in the focused pane (route, terminal, chat, artifact, mini-app).
Open a new tab in the focused pane (route, terminal, chat, artifact, mini-app).
No parameter schema in public metadata yet.
iyke_splitSplit a pane horizontally or vertically.
Split a pane horizontally or vertically.
No parameter schema in public metadata yet.
iyke_focusFocus a pane by id or 1-based DFS leaf index (⌃1..⌃6).
Focus a pane by id or 1-based DFS leaf index (⌃1..⌃6).
No parameter schema in public metadata yet.
iyke_closeClose a pane (focused if `pane_id` omitted).
Close a pane (focused if `pane_id` omitted).
No parameter schema in public metadata yet.
iyke_domAccessibility-tree snapshot of the focused pane (Playwright-style refs).
Accessibility-tree snapshot of the focused pane (Playwright-style refs).
No parameter schema in public metadata yet.
iyke_logsLast 500 console + error logs from the running webview.
Last 500 console + error logs from the running webview.
No parameter schema in public metadata yet.
iyke_networkLast 100 fetch/XHR network entries with status + duration.
Last 100 fetch/XHR network entries with status + duration.
No parameter schema in public metadata yet.
iyke_screenshotPNG screenshot of the window or a specific pane.
PNG screenshot of the window or a specific pane.
No parameter schema in public metadata yet.
iyke_waitWait until a predicate is satisfied (text/selector/ref/gone).
Wait until a predicate is satisfied (text/selector/ref/gone).
No parameter schema in public metadata yet.
iyke_clickClick an element by ref, selector, or text.
Click an element by ref, selector, or text.
No parameter schema in public metadata yet.
iyke_typeType into an input/textarea/contenteditable.
Type into an input/textarea/contenteditable.
No parameter schema in public metadata yet.
iyke_keyDispatch a keyboard combo (e.g. `Ctrl+S`, `Meta+K`).
Dispatch a keyboard combo (e.g. `Ctrl+S`, `Meta+K`).
No parameter schema in public metadata yet.
iyke_query_cacheDump the TanStack Query cache for the focused pane.
Dump the TanStack Query cache for the focused pane.
No parameter schema in public metadata yet.
iyke_devtoolsOpen Chrome DevTools (debug builds only).
Open Chrome DevTools (debug builds only).
No parameter schema in public metadata yet.
iyke_iframe_stateRead the latest published state object for an iframe pane.
Read the latest published state object for an iframe pane.
No parameter schema in public metadata yet.
iyke_iframe_sendSend a fire-and-forget postMessage to an iframe pane.
Send a fire-and-forget postMessage to an iframe pane.
No parameter schema in public metadata yet.
iyke_project_createCreate a project (slug + display name; optional root_path, icon, color, description).
Create a project (slug + display name; optional root_path, icon, color, description).
No parameter schema in public metadata yet.
iyke_project_updatePatch fields on an existing project (display_name, root_path, icon, color, description, position).
Patch fields on an existing project (display_name, root_path, icon, color, description, position).
No parameter schema in public metadata yet.
iyke_project_listList projects in switcher order; pass `include_archived=true` to surface archived ones.
List projects in switcher order; pass `include_archived=true` to surface archived ones.
No parameter schema in public metadata yet.
iyke_project_archiveSoft-delete a project; refuses to archive the built-in Default project.
Soft-delete a project; refuses to archive the built-in Default project.
No parameter schema in public metadata yet.
iyke_project_set_activeSwitch the shell's active project; refetches project-scoped queries.
Switch the shell's active project; refetches project-scoped queries.
No parameter schema in public metadata yet.
iyke_project_get_activeReturn the currently active project.
Return the currently active project.
No parameter schema in public metadata yet.
Sponsors
Agent CaffeineSponsoredClose your lid, come back to finished work
SnugSponsoredThe clipboard manager for the AI eraPromote your product hereReach 125k+ visitors monthly
WaxSponsoredBlock anything with supervision, without erasing your iPhonePromote your product hereReach 125k+ visitors monthly
knobsSponsoredSee your site on any phone, any day, in any languageReadme
[!IMPORTANT]
This repository has moved — do not build from it
Development of
@ikenga/mcp-iykecontinues in the ikenga-pkgs monorepo:→ Royalti-io/ikenga-pkgs/packages/mcp/iyke
This repo was last updated on 15 May 2026 and is now archived and read-only.
Why this matters if you cloned it. The state left here is neither the last release nor the current one: its
package.jsondeclares0.1.2, but its source carries a partially-migrated tool set from the period before the code moved back into the monorepo. Building from this tree gives you something that was never published. Anything you install from npm is unaffected.
- npm (unchanged, still the right package):
@ikenga/mcp-iyke- Issues and PRs: please open them on ikenga-pkgs
@ikenga/mcp-iyke
Details
- Repository
- github.com/royalti-io/ikenga-pkg-mcp-iyke
- Website
- github.com/Royalti-io/ikenga-pkg-mcp-iyke#readme
- Package
@ikenga/mcp-iyke- Transport
- STDIO
- Registry
- MCP registry, active