@ikenga/mcp-iyke
This MCP server provides full programmatic control over a running Ikenga desktop app session, enabling agents to automate UI interactions, inspect runtime state, manage projects/sessions/packages, and leverage scoped storage and coordination tools.
UI Automation & Navigation: switch sidebar modes, navigate/focus/split/close panes, open new tabs (route, terminal, chat, artifact, mini-app), and inspect the pane tree.
Runtime Inspection & Driving: capture accessibility snapshots, read console/network logs, take screenshots, wait for UI conditions, perform clicks/typing/keyboard strokes, dump query caches, and open DevTools (debug builds).
Iframe Control: read published state from iframe panes and send postMessage actions.
Project Management: create, update, list, archive, and set/get the active project.
Chat Sessions: list, move, and start Claude chat threads per project.
MCP & Package Management: list/restart MCP servers, check package trust status and violations, install/change scope/uninstall packages.
Secrets Vault: securely read, write, delete, and list secrets per scope.
Scratchpads: create, append, read, list, and delete project-scoped Markdown notes.
Key-Value Store: store, retrieve, delete, and list small JSON values.
Distributed Locks: acquire, check status, release, and renew project-scoped lease locks for resource coordination.
Todos: create, update, list, and complete project-scoped todos with tags, assignees, and blockers.
Timers: schedule one-shot timers with OS notifications and agent inbox delivery, cancel, and list them.
Agent Registration: register an agent for lock attribution and inbox messages.
Layout Management: get and reset saved per-project layout state.
Claude Asset Management: list, pin, and unpin Claude-config assets (skills, agents, commands, hooks, MCPs) to resolve conflicts across sources.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@@ikenga/mcp-iyke list my projects"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
This repository has moved — do not build from it
Development of @ikenga/mcp-iyke continues 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.json declares 0.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-iykeIssues and PRs: please open them on ikenga-pkgs
@ikenga/mcp-iyke
A Model Context Protocol server that exposes the Ikenga desktop app's iyke control bridge — so any MCP client (Claude Code, Cursor, custom agents) can drive a running Ikenga session the same way a developer types into the iyke CLI at a shell.
Related MCP server: KiCad MCP Server
What this is
Ikenga is a Tauri-based AI workspace shell with a manifest-driven package kernel. While the app is running, it exposes a localhost HTTP server (with a bearer token in control.json) that lets external tools introspect and drive the live UI: switch panes, navigate routes, take DOM snapshots, click elements, read logs, capture screenshots.
This package wraps that HTTP server in MCP so an LLM agent can use it natively. Tools mirror the iyke CLI subcommands.
Install
Via Claude Code (recommended)
npm install -g @ikenga/mcp-iyke
claude mcp add iyke -s user -- iyke-mcpAfter that, any Claude Code session can call iyke_state, iyke_go, iyke_mode, iyke_open, iyke_split, iyke_focus, iyke_close, plus the runtime-inspection tools (iyke_dom, iyke_logs, iyke_network, iyke_screenshot, iyke_wait, iyke_click, iyke_type, iyke_key, iyke_query_cache, iyke_devtools), iframe tools (iyke_iframe_state, iyke_iframe_send) and project tools (iyke_project_create, iyke_project_update, iyke_project_list, iyke_project_archive, iyke_project_set_active, iyke_project_get_active).
Via npx (no install)
claude mcp add iyke -s user -- npx -y @ikenga/mcp-iykeFrom source (for contributors)
git clone https://github.com/Royalti-io/ikenga-pkg-mcp-iyke.git
cd ikenga-pkg-mcp-iyke
npm install
npm run buildThen point your MCP client at node /path/to/ikenga-pkg-mcp-iyke/dist/index.js.
Tools
Layout & navigation
Tool | Purpose |
| Show current sidebar mode + focused pane's route + full pane tree. |
| Navigate the focused pane to a route path. |
| Switch sidebar activity mode. |
| Open a new tab in the focused pane (route, terminal, chat, artifact, mini-app). |
| Split a pane horizontally or vertically. |
| Focus a pane by id or 1-based DFS leaf index (⌃1..⌃6). |
| Close a pane (focused if |
Runtime inspection & driving
Tool | Purpose |
| Accessibility-tree snapshot of the focused pane (Playwright-style refs). |
| Last 500 console + error logs from the running webview. |
| Last 100 fetch/XHR network entries with status + duration. |
| PNG screenshot of the window or a specific pane. |
| Wait until a predicate is satisfied (text/selector/ref/gone). |
| Click an element by ref, selector, or text. |
| Type into an input/textarea/contenteditable. |
| Dispatch a keyboard combo (e.g. |
| Dump the TanStack Query cache for the focused pane. |
| Open Chrome DevTools (debug builds only). |
Iframe runtime state
Tool | Purpose |
| Read the latest published state object for an iframe pane. |
| Send a fire-and-forget postMessage to an iframe pane. |
Projects
Tool | Purpose |
| Create a project (slug + display name; optional root_path, icon, color, description). |
| Patch fields on an existing project (display_name, root_path, icon, color, description, position). |
| List projects in switcher order; pass |
| Soft-delete a project; refuses to archive the built-in Default project. |
| Switch the shell's active project; refetches project-scoped queries. |
| Return the currently active project. |
Trust boundary
The MCP server reads control.json from the platform-specific app-local-data directory (~/Library/Application Support/app.ikenga/control.json on macOS, $XDG_DATA_HOME/app.ikenga/control.json on Linux, %APPDATA%/app.ikenga/control.json on Windows). The control file contains:
port— localhost port the in-app HTTP server is listening ontoken— bearer token required on every requestpid— owning process PID (used to detect stale files)
A stale control.json left behind by kill -9 is auto-deleted once it's at least 5 minutes old; younger stale files are reported (likely a launch race) so we don't clobber a starting app.
If the Ikenga desktop app isn't running, every tool call fails with a structured error rather than hanging — your agent reads the failure and reports it instead of silently waiting.
The MCP server only ever talks to 127.0.0.1 on the port from control.json, with the bearer token from the same file. No outbound network, no telemetry.
Compatibility
Ikenga shell: any version exposing the v1
control.jsonschema.Node.js: ≥ 20.
Bun: runs without compilation (
bun src/index.ts).MCP SDK:
@modelcontextprotocol/sdk^1.23.0.
Versioning
This package follows SemVer 2.0.0. Major-version bumps may break MCP tool names or argument shapes; minor bumps add new tools or non-breaking improvements; patches fix bugs.
The iyke HTTP protocol version (the in-app server's API surface) is independent — it's pinned via schema_version: 1 in control.json. This package currently supports protocol v1 only.
Contributing
Contributions welcome. See CONTRIBUTING.md for setup, conventions, and the DCO. By contributing, you agree your contributions are licensed under Apache 2.0 (matching the repo).
For bugs or feature requests, open an issue. For security issues, see SECURITY.md — please don't open a public issue.
License
Apache License 2.0 — Copyright (c) 2026 Royalti, Inc.
Related
Ikenga shell — the desktop app this drives.
@ikenga/contract — shared manifest + iyke runtime constants.
Model Context Protocol — the protocol this server speaks.
Available Tools
67 toolsiyke_agent_registerA
Register this agent so locks and timers can attribute work to it. Returns an opaque id. Pass the id as holder to iyke_lock_acquire. Repeated calls with the same {id} bump last_seen_at; omit id to mint a new one.
Inputs: name (required), id, model, metadata.
iyke_claude_asset_list_pinsA
List Claude-config asset pins for a scope. Scope is "workspace" (cross-project) or "project:" (this project only). Returns one entry per pin with preferred_tier + preferred_source.
Inputs: scope (required).
iyke_claude_asset_pinA
Pin a preferred provider for a Claude-config asset name in a scope. When discovery finds the same asset name in multiple tiers (e.g. a code-reviewer agent in both ~/.claude/ and a project pkg), the lowest tier wins by default; a pin overrides that. Scope is "workspace" (cross-project) or "project:" (this project only). preferred_tier is one of personal | workspace_pkg | project | project_pkg. preferred_source is the pkg id (or "personal" for ~/.claude/) — omit to match any source in the tier.
Inputs: scope (required), asset_kind (required), asset_name (required), preferred_tier (required), +1 more.
iyke_claude_assets_listA
List Claude-config assets (skills, agents, commands, hooks, mcps) discovered for a project, grouped by provider tier. Returns a tree where each asset name maps to one or more AssetSource entries; multiple entries on the same name indicate a conflict between tiers. Defaults to the active project; pass project_id to query a specific one. Use this to see what an agent will actually load in a project context.
Inputs: kind, project_id.
iyke_claude_asset_unpinA
Remove a pinned resolution. Falls back to the default lowest-tier-wins rule.
Inputs: scope (required), asset_kind (required), asset_name (required).
iyke_clickB
Click an element. Specify exactly one of ref (from iyke_dom), selector (CSS), or text (innerText match). Refs are most reliable.
Inputs: ref, pane, text, selector.
iyke_closeA
Close a pane (or the focused pane if pane_id omitted). Closes the entire pane and all its tabs — to close a single tab from the in-app keyboard, use ⌘⇧W (⌘W closes the whole pane). Refuses to close the last remaining pane.
Inputs: pane_id.
iyke_devtoolsA
Open Chrome DevTools for the main webview (debug builds only). Returns 503 in production builds.
Inputs: no named parameters.
iyke_domA
Take an accessibility-tree snapshot of the focused pane. Returns Playwright-style text plus structured JSON. Each interactive element gets a stable ref like e1, e2; pass that ref to iyke_click / iyke_type / iyke_key. Refs invalidate on the next snapshot or page navigation. Use query for substring filter, all=true to include hidden elements.
Inputs: all, pane, query.
iyke_focusA
Focus a specific pane. Provide either pane_id (leaf id from iyke_state response — shell.panes.leaves[].id) or index (1-based DFS leaf index, matching the in-app ⌃1..⌃6 keyboard shortcuts).
Inputs: index, pane_id.
iyke_goA
Navigate the focused pane to a route path inside the Ikenga desktop app (e.g. "/notes/today"). Path must start with "/". This replaces the focused pane's active tab content; use iyke_open with kind=route to add a new tab instead.
Inputs: path (required).
iyke_iframe_sendB
Send a fire-and-forget postMessage to an iframe pane. The iframe bridge listens for known kinds (e.g. "story-select") and acts on the payload. Use to drive mini-app actions from outside the running app.
Inputs: kind (required), pane (required), payload.
iyke_iframe_stateC
Read the latest published state object for an iframe pane (storyboard cursor, comp current frame, etc.). Iframes call publishState(key, value) from their iyke-bridge to expose runtime state for inspection.
Inputs: pane (required).
iyke_keyA
Dispatch a keyboard combo. Use names like "Enter", "Escape", "Tab", "ArrowDown", and modifiers Ctrl/Alt/Shift/Meta separated by + or , (e.g. "Ctrl+S", "Meta+K"). Optional ref/selector targets a specific element; otherwise the active element receives.
Inputs: combo (required), ref, pane, selector.
iyke_kv_deleteB
Delete a KV entry. Idempotent.
Inputs: key (required), scope.
iyke_kv_getB
Read a JSON value at scope+key. Returns { key, value: null } if absent (200, not 404).
Inputs: key (required), scope.
iyke_kv_listB
List KV entries in a scope. prefix filter narrows by key prefix.
Inputs: scope, prefix.
iyke_kv_setA
Store a small JSON value at scope+key. Cap 64 KB per value; cap 1 MB total per scope. For larger durable text, use scratchpads. Scope defaults to active project.
Inputs: key (required), value (required), scope.
iyke_layout_getA
Get the saved layout (pane tree, files-explorer state, panel sizes) for a project. Returns the raw layout_state row contents — each field is the JSON the shell wrote, or null when nothing has been saved for that key. Defaults to the active project; pass project_id to query a specific one. Useful for the conductor pattern (an agent inspecting "what does this project look like to the user").
Inputs: project_id.
iyke_layout_resetA
Reset a project's saved layout — deletes the pane tree, files-explorer state, and panel sizes rows. Next time the user (or anyone) switches to this project, the layout-swap orchestrator finds no saved state and leaves the current view in place. Use this to recover from a wedged layout or as part of a clean-slate workflow.
Inputs: project_id (required).
iyke_lock_acquireA
Acquire a project-scoped lease lock on a named resource. Use for short-lived coordination around shared files, plans, migrations. holder is the agent id from iyke_agent_register. ttl_ms defaults to 60000 (clamped to [1000, 600000]). If wait_ms is set, blocks up to that long for an existing lock to expire.
Inputs: holder (required), resource (required), scope, ttl_ms, +1 more.
iyke_lock_releaseA
Release a lock you hold. No-op if held by someone else or already expired.
Inputs: holder (required), resource (required), scope.
iyke_lock_renewA
Extend a lock you hold by ttl_ms. Useful for long-running work that needs more time than the original lease.
Inputs: holder (required), resource (required), scope, ttl_ms.
iyke_lock_statusA
Check whether a resource is currently locked (active leases only). Returns held=false if the lease has expired.
Inputs: resource (required), scope.
iyke_logsA
Read recent console + error logs (last 500) from the running webview. Includes window error and unhandledrejection captures.
Inputs: level, since, source.
iyke_mcp_listA
List MCP servers visible from a project. Returns each (server name × source) pair so conflicts across tiers are surfaced separately. Each entry reports: source tier (personal | workspace_pkg | project | project_pkg), provider (pkg id or "personal"), lifecycle (long-lived | per-call | on-demand), live state (running / parked / crashed / blocked / not-started / on-demand), and the source file path. Defaults to the active project; pass project_id to query a specific one.
Inputs: project_id.
iyke_mcp_restartA
Restart a supervised MCP server by pkg id. Restarts every long-lived MCP entry the pkg declares (the supervisor keys per pkg, not per server name). Useful when a child has wedged. Fails with 404 if the pkg is not supervised — per-call MCPs spawn fresh on every tool invocation and have nothing persistent to restart.
Inputs: pkg_id (required).
iyke_modeA
Switch the activity-bar sidebar mode. Valid modes: app, files, agents, sessions, settings, storyboard, video-engine, canvas-design, image-generator. The first five are core; the rest are mini-apps.
Inputs: mode (required).
iyke_networkC
Read recent fetch + XHR network activity (last 100). Each entry has method, url, status, duration_ms, and error if it failed.
Inputs: since, source.
iyke_openA
Open a new tab in the focused pane. kind selects the view type. For "route" pass path; "terminal" optionally cmd (a shell command string); "chat" requires session_id; "artifact" requires path; "mini-app" requires name.
Inputs: kind (required), cmd, name, path, +1 more.
iyke_pkg_install_scope_setA
Change the scope of an installed pkg. scope="workspace" (always loaded) or "project:" (loaded only when that project is active). Triggers a kernel reconcile so sidecars start/stop accordingly.
Inputs: scope (required), pkg_id (required).
iyke_pkg_listA
List installed pkgs visible from the active project. Workspace-scoped pkgs are always included; project-scoped pkgs are included only when their project is active unless include_other_projects=true. Each entry: id, version, install_path, enabled, source, scope ("workspace" | "project:"), active_now.
Inputs: kind, include_other_projects.
iyke_pkg_trust_listA
List trust state for every installed pkg. Returns one entry per pkg with state (auto_trusted / auto_granted / granted / needs_approval), declared sensitive permissions summary, and last grant timestamp when applicable. Use when surveying which third-party pkgs need user approval before their MCP tools can be invoked.
Inputs: no named parameters.
iyke_pkg_trust_statusA
Get the trust state for a single installed pkg. Returns one of: auto_trusted (built-in com.ikenga.* shipped with the shell), auto_granted (no sensitive permissions declared), granted (user approved a specific manifest version), or needs_approval (sensitive perms declared but no current grant; either never approved, perms changed since last grant, or explicitly revoked). When state is needs_approval, MCP tools/call against this pkg returns the structured trust_required error until the user grants approval via Settings → Pkgs.
Inputs: pkg_id (required).
iyke_pkg_uninstallA
Uninstall a pkg. Stops its sidecars, removes its registry entries, deletes its files. Project-scoped state in iyke_kv / iyke_scratchpads / iyke_todos survives. Builtins (com.ikenga.*) cannot be uninstalled.
Inputs: pkg_id (required).
iyke_pkg_violations_listA
List kernel-level permission-violation audit rows newest-first. Today only shell.execute denials write here (a pkg attempted to spawn a binary outside its manifest's declared allowlist). Returns one entry per attempt with attempted (the resolved command), declared (the manifest allowlist at attempt time, comma-joined), scope_kind ('shell.execute'), pkg_id, and occurred_at (unix millis). Pass pkg_id to filter to one pkg; omit for a cross-pkg view. limit defaults to 100 and is hard-capped at 1000.
Inputs: limit, pkg_id.
iyke_project_archiveA
Archive a project (soft-delete — sets archived_at, no data removed). The project disappears from the default switcher list but its sessions/pkgs/todos remain on disk and can be restored by a later iyke_project_update if needed. Refuses to archive the built-in "Default" project. If the archived project was active, the shell falls back to Default automatically.
Inputs: id (required).
iyke_project_createA
Create a new project in the Ikenga shell. Projects scope chats, installed pkgs, pane layouts, todos, scratchpads and cron jobs — switching project rebinds those surfaces. Slug id must match ^[a-z0-9][a-z0-9_-]{0,63}$ and be unique; default is reserved. display_name is freely Unicode, capped at 120 chars. root_path is optional but recommended — it becomes the cwd for new chats spawned inside the project. color is a hex string used for the activity-bar dot. Use when the user asks to set up a new working context (a codebase, a label, an experiment).
Inputs: id (required), display_name (required), icon, color, +2 more.
iyke_project_get_activeA
Return the currently active project (id, display_name, root_path, icon, color, description, position, is_default, created_at). Call this before iyke_project_set_active or any project-scoped mutation so an agent knows which project the user is in.
Inputs: no named parameters.
iyke_project_listA
List projects in switcher order (position ASC, then created_at). Each entry has id, display_name, root_path, icon, color, description, position, is_default, created_at, archived_at. Archived projects are hidden by default — pass include_archived=true to surface them (e.g. when an agent is restoring an old project).
Inputs: include_archived.
iyke_project_set_activeA
Switch the shell's active project. Subsequent new chats, scratchpads, todos and pkg installs default to this project; existing project-scoped TanStack queries (sessions, pkgs, todos, scratchpads, cron) refetch automatically. Does NOT navigate panes — pane contents stay put until a phase-2/6-aware surface reads the new active id. Fails if the id is unknown or archived.
Inputs: id (required).
iyke_project_updateA
Patch fields on an existing project. Only the fields you pass in patch are touched — omit a field to leave it as is. Pass null to clear a nullable field (root_path, icon, color, description). position controls the project ordering in the activity-bar switcher (lower = earlier). Cannot change id; create a new project and migrate instead.
Inputs: id (required), patch (required).
iyke_query_cacheA
Dump the TanStack Query cache: queryKey, status, fetchStatus, isStale, dataUpdatedAt, errorUpdatedAt, error, and a 200-char data preview for each entry. Useful for diagnosing stale data or failed fetches.
Inputs: pane.
iyke_scratchpad_appendA
Append to a scratchpad without overwriting. Creates it if missing. with_separator=true (default) inserts a horizontal rule + timestamp between the prior body and the new content.
Inputs: body (required), name (required), scope, with_separator.
iyke_scratchpad_deleteB
Delete a scratchpad by scope+name. Idempotent.
Inputs: name (required), scope.
iyke_scratchpad_listA
List scratchpads in a scope (defaults to active project). Each entry has id, name, updated_at, and a 200-char preview.
Inputs: scope.
iyke_scratchpad_readA
Read a scratchpad by scope+name. 404 if missing. Returns id, body, updated_at.
Inputs: name (required), scope.
iyke_scratchpad_writeA
Create or replace a project-scoped Markdown scratchpad. Use for plans, handoffs, working context that should outlive a chat. scope defaults to the active project (project:<active_id>); pass "workspace" or "pkg:" to opt out. name is a slug unique within scope. Body cap 1 MB.
Inputs: body (required), name (required), scope.
iyke_screenshotA
Capture a PNG screenshot of either the full window or a specific pane. Returns the saved path, dimensions, and byte count. Default writes to ~/.local/share/ikenga/screenshots/.
Inputs: target, pane_id, out_path.
iyke_secret_deleteA
Delete a secret from the given scope. Same scope semantics as iyke_secret_get. Returns ok even if the key did not exist. Does not touch the legacy unscoped key — to clean up legacy entries, delete the value at the unscoped key directly.
Inputs: key (required), scope.
iyke_secret_getA
Read a secret from the vault. The scope arg partitions the read: omit it (or pass an empty string) to read from the active project; pass "workspace" to read a cross-project shared secret; pass "project:" or "pkg:" to target a specific partition. Returns the value as a string, or null when the key does not exist in the chosen scope. Falls back transparently to the legacy unscoped key when a scoped value is missing (with a deprecation log on the host).
Inputs: key (required), scope.
iyke_secret_listA
List secret KEY NAMES (not values) in a scope. Same scope semantics as iyke_secret_get. Returns sorted bare key names — the scope prefix is stripped. Use to inventory what secrets are stored in a project without revealing values.
Inputs: scope.
iyke_secret_setA
Write a secret to the vault under the given scope (same scope semantics as iyke_secret_get). Triggers a re-dump of the runtime env-vault file so sidecars and per-call MCP children pick up the new value on next spawn. Use this sparingly — secrets are sensitive and the values land in the user's encrypted Stronghold snapshot.
Inputs: key (required), value (required), scope.
iyke_session_listA
List Claude chat sessions. Filter by project (defaults to active); pass include_all=true to list across all projects. Returns at most 50 threads by default (max 200). Each entry has id, title, cwd, project_id, claude_session_id, created_at, updated_at.
Inputs: limit, project_id, include_all.
iyke_session_moveA
Move a chat thread between projects. Metadata-only — does not restart the claude subprocess. The cwd captured at spawn time stays whatever it was. Fails if the target project is unknown or archived.
Inputs: thread_id (required), project_id (required).
iyke_session_start_in_projectA
Mint a new Claude chat thread attached to a project. The shell resolves the project root as the session cwd, builds the layered Claude-config overlay dir (skills + agents + commands + merged .mcp.json) for the spawn, and routes the request through the ACP session/new handler. Returns the new thread_id; the actual subprocess spawns lazily on the first prompt — fire acp_prompt or open /sessions/$threadId in the UI to send the initial message. initial_prompt is currently informational only (the bridge does not forward it yet).
Inputs: project_id (required), cwd, initial_prompt.
iyke_splitA
Split the focused pane (or a specific pane via pane_id) into two. "horizontal" splits side-by-side; "vertical" splits top-bottom. Subject to the in-app MAX_LEAVES cap (currently 6).
Inputs: direction (required), pane_id.
iyke_stateA
Get the current state of the Ikenga desktop app — sidebar mode, focused pane route, and the full pane tree under shell.panes. shell.panes has shape { leaves: [{ id, focused, activeTabIdx, tabs: [{kind,title}] }], tree: }; use leaves[].id with iyke_focus or iyke_close (pane_id) to operate on a specific pane. Call this before iyke_go / iyke_mode / iyke_focus / iyke_close to check what the user is currently looking at.
Inputs: no named parameters.
iyke_timer_cancelA
Cancel a pending timer by id. No-op if already fired or cancelled. Returns { cancelled: bool }.
Inputs: id (required).
iyke_timer_listA
List timers in a scope (defaults to active project). Optional status filter: pending | fired | cancelled. Returns timers sorted by fire_at ascending.
Inputs: scope, status.
iyke_timer_scheduleA
Schedule a one-shot timer in the active project (or specified scope). Pass either fire_at (absolute epoch-ms) or delay_ms (relative from now), not both. When the timer fires the shell emits an OS notification; if agent_id is set, an entry also lands in that agent's inbox (delivered on its next tool call, 24h TTL).
Inputs: title (required), body, scope, fire_at, +2 more.
iyke_todo_completeA
Mark a todo as done and stamp completed_at. Equivalent to iyke_todo_update with status=done.
Inputs: id (required).
iyke_todo_createB
Create a project-scoped todo. Tags are free-form strings; assignee is a free-form name (agent or user). Set blocker_id to mark this todo as blocked by another.
Inputs: title (required), body, tags, scope, +2 more.
iyke_todo_listB
List todos in a scope (defaults to active project). Filter by status, tag, assignee.
Inputs: tag, scope, status, assignee.
iyke_todo_updateA
Partial update of a todo. Only supplied fields are changed. Pass status="done" or use iyke_todo_complete for the common case.
Inputs: id (required), body, title, status, +2 more.
iyke_typeA
Type text into an input/textarea/contenteditable element. Specify exactly one of ref or selector. By default appends; pass replace=true to overwrite the existing value.
Inputs: text (required), ref, pane, replace, +1 more.
iyke_waitA
Wait until a predicate is satisfied or timeout. Use this after iyke_click / iyke_go to wait for the new state to render, instead of fixed sleeps. Returns { satisfied, elapsed_ms, message? }.
Inputs: kind (required), value (required), pane, timeout_ms.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 67 tools
Most tools are cleanly separated by domain prefix (todo_, timer_, secret_, kv_, lock_, project_, scratchpad_) and their descriptions pin down exact resources and actions. A few are potentially confusable (iyke_go vs iyke_open, iyke_todo_complete vs iyke_todo_update), but the descriptions draw clear boundaries.
The strong iyke_ prefix and snake_case domain grouping (todo_create, secret_get, lock_acquire) give a recognizable order, but many UI/interaction tools are bare verbs or nouns (iyke_go, iyke_mode, iyke_dom, iyke_wait, iyke_click, iyke_state). This mix of noun_verb and action-only names is readable but not a single consistent convention.
67 tools is far beyond the 50+ extreme threshold, and even though the Ikenga domain is broad, bundling UI automation, projects, sessions, packages, secrets, storage, and locks into one MCP surface creates a heavy selection problem. The count would be more manageable split into smaller domain-specific servers.
The suite covers full CRUD-style surfaces for KV, scratchpads, secrets, and locks, plus coherent UI automation (state/dom/click/type/wait) and project/session/todo management. Notable gaps exist—no todo delete, no package install, no direct session message/send, and no timer update—but most workflows can proceed or work around them.
Maintenance
Related MCP Connectors
Remote MCP server to read and edit GanttFather projects: tasks, dates, dependencies, critical path.
Remote MCP server for AIStoryHub: stories, chapters, story bible, Voiceprints, AI generation.
Ovanek MCP: Model Context Protocol server for Ovanek platform tools; writes are dry-run by default.
Nifty's MCP server — exposes tasks, projects, messages, and files as tools for AI agents.
Related MCP Servers
- AlicenseBqualityDmaintenanceMCP server exposing KiCad PCB Editor functionality via IPC API.4144 PyPI1MIT
- FlicenseNot gradedqualityDmaintenanceA Model Context Protocol (MCP) server that exposes KiCad PCB design automation tools to AI assistants and other MCP clients.-
- AlicenseNot gradedqualityDmaintenanceMCP server for interacting with the Phiacta knowledge platform.GPL 3.0
- AlicenseNot gradedqualityNot gradedmaintenanceA local MCP server that enables MCP-compatible AI clients to inspect and control the currently open scene in a running Autodesk VRED Professional 2027 instance via a secure bridge, supporting read-only inspection and gated mutations like selection, visibility, transforms, and screenshots.MIT