Ikenga iyke (control bridge)
NPM · @IKENGA/MCP-IYKE · SCANNED AUG 3
Drive a running Ikenga desktop app from MCP clients — DOM, click, type, navigate, screenshot.
Available components
How this component scores in each security and reliability category. Every signal is checked automatically from public evidence about the published package, including repeated runs of it in an isolated sandbox, and we only credit what we can confirm. How we score →
Supply Chain Security87
- No malware found by supply-chain analysis.Pass
- Only part of the dependency tree could be resolved (96 of 100), so this covers what we could see, not the whole tree.Partial
- No install/post-install scripts declared.Pass
- Only part of the dependency tree could be resolved (96 of 100), so this covers what we could see, not the whole tree. View diagnostics → Partial
Provenance & Transparency45
- Source repository is publicly reachable at the declared URL. View diagnostics → Pass
- Provenance check failed: no build-provenance attestation is published. See how to fix → View diagnostics → Fail
- Clear OSI-approved license (Apache-2.0).Pass
- Actively maintained (last published 58 days ago).Pass
- Disclosure check failed: no security disclosure policy was found in the source repository. See how to fix → Fail
Schema Quality & AI Usability70
- AI-judged instruction clarity (good).Pass
- Tool/resource definitions use about 1526 tokens (~80/item across 19 items; 19 tools + 0 resources), lean.Pass
- Usage-examples check failed: none of the tools include examples. See how to fix → Fail
Stability & Change Management27
- Stability observed for 8 of 30 days with no destabilising changes; credit accrues until the full window elapses.Partial
Tool Coverage76
- 100% of tools have a non-trivial description (not blank, and not just the tool's name).Pass
- 29% of tool parameters carry a description.Partial
Capabilities100
- Implements a supported MCP spec version (2025-11-25); the latest is 2026-07-28.Pass
Add this component to your MCP client. Where a client-specific snippet is available, pick your client below and copy it straight into your config; otherwise use the connection detail shown.
npm · @ikenga/mcp-iyke
claude mcp add royalti-io-ikenga-pkg-mcp-iyke -- npx -y @ikenga/mcp-iyke
codex mcp add royalti-io-ikenga-pkg-mcp-iyke -- npx -y @ikenga/mcp-iyke
{
"$schema": "https://opencode.ai/config.json",
"mcp": {
"royalti-io-ikenga-pkg-mcp-iyke": {
"type": "local",
"command": [
"npx",
"-y",
"@ikenga/mcp-iyke"
],
"enabled": true
}
}
} openclaw mcp add royalti-io-ikenga-pkg-mcp-iyke --command npx --arg -y --arg @ikenga/mcp-iyke
mcp_servers:
royalti-io-ikenga-pkg-mcp-iyke:
command: "npx"
args: ["-y", "@ikenga/mcp-iyke"] {
"mcpServers": {
"royalti-io-ikenga-pkg-mcp-iyke": {
"command": "npx",
"args": [
"-y",
"@ikenga/mcp-iyke"
]
}
}
} Every change we have recorded for this component, newest first. Security-relevant changes are always shown. ▲ marks a change for the better, ▼ a change for the worse; unmarked changes are neutral.
- 3 Aug 26 +4
- Stability: unverified → 0.27 ▲ functional
- 2 Aug 26 +5
- Known CVEs: partial → unverified ▼ security
- Stability: Stability not yet verified: we do not have a sandbox capture of the MCP schema this version of the package serves yet. security
- Security disclosure: fail → unverified ▼ functional
- Capabilities: pass → unverified ▼ functional
- Dependency health: partial → unverified ▼ functional
- Schema quality: unverified → good ▲ functional
- 1 Aug 26 +38
- Provenance: unverified → fail ▼ security
- Malware scan: unverified → pass ▲ security
- Install scripts: unverified → pass ▲ security
- Known CVEs: unverified → partial ▲ security
- Stability: Stability not yet verified: not enough scan history yet (needs a 30-day window). security
- License: unverified → pass ▲ functional
- Dependency health: unverified → partial ▲ functional
- Maintenance: unverified → pass ▲ functional
- MCP protocol: unverified → pass ▲ functional
- Licence: Apache-2.0 functional
- 31 Jul 26 −24
- We updated how we score, so this day's move reflects our rubric, not a change to the server See what changed → functional
- 27 Jul 26 43
First indexed and scored.
Diagnostic detail from the automated scan of this channel: what the scanner observed at each step, so you can see exactly where a check passed or failed. It is informational only and never changes the trust score.
Captured 3 Aug 2026 · Analysed npm/@ikenga/[email protected]
Provenance none
Ecosystem: npm · Outcome: none
Dependencies 96 packages
96 packages in the resolved dependency tree · 95 deprecated · 29 stale.
The dependency tree was only partially resolved, so these counts may be incomplete.
The tools this component advertises to a client, with an estimated token cost for each. Expand a tool to see its parameters and schema. The per-tool counts are indicative and are not scored directly; the schema's total context footprint is one signal in Schema Quality & AI Usability.
iyke_click ~75
Click an element. Specify exactly one of `ref` (from iyke_dom), `selector` (CSS), or `text` (innerText match). Refs are most reliable.
| Name | Type | Req | Description |
|---|---|---|---|
| pane | string | — | — |
| ref | string | — | — |
| selector | string | — | — |
| text | string | — | — |
No output schema declared.
No examples provided.
iyke_close ~82
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.
| Name | Type | Req | Description |
|---|---|---|---|
| pane_id | string | — | Optional. Defaults to focused pane. |
No output schema declared.
No examples provided.
iyke_devtools ~31
Open Chrome DevTools for the main webview (debug builds only). Returns 503 in production builds.
Input schema present but exposes no named parameters.
No output schema declared.
No examples provided.
iyke_dom ~120
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.
| Name | Type | Req | Description |
|---|---|---|---|
| all | boolean | — | Include hidden + aria-hidden elements. |
| pane | string | — | — |
| query | string | — | Substring filter against role/name/value. |
No output schema declared.
No examples provided.
iyke_focus ~74
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).
| Name | Type | Req | Description |
|---|---|---|---|
| index | integer | — | — |
| pane_id | string | — | — |
No output schema declared.
No examples provided.
iyke_go ~77
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.
| Name | Type | Req | Description |
|---|---|---|---|
| path | string | yes | Route path, must start with "/". |
No output schema declared.
No examples provided.
iyke_iframe_send ~76
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.
| Name | Type | Req | Description |
|---|---|---|---|
| kind | string | yes | — |
| pane | string | yes | — |
| payload | — | — | — |
No output schema declared.
No examples provided.
iyke_iframe_state ~61
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.
| Name | Type | Req | Description |
|---|---|---|---|
| pane | string | yes | — |
No output schema declared.
No examples provided.
iyke_key ~105
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.
| Name | Type | Req | Description |
|---|---|---|---|
| combo | string | yes | — |
| pane | string | — | — |
| ref | string | — | — |
| selector | string | — | — |
No output schema declared.
No examples provided.
iyke_logs ~76
Read recent console + error logs (last 500) from the running webview. Includes window error and unhandledrejection captures.
| Name | Type | Req | Description |
|---|---|---|---|
| level | string | — | — |
| since | integer | — | Only entries with ts >= this (epoch ms). |
| source | string | — | Filter by pane source ("shell" or leaf id). |
No output schema declared.
No examples provided.
iyke_mode ~60
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.
| Name | Type | Req | Description |
|---|---|---|---|
| mode | string | yes | — |
No output schema declared.
No examples provided.
iyke_network ~54
Read recent fetch + XHR network activity (last 100). Each entry has method, url, status, duration_ms, and error if it failed.
| Name | Type | Req | Description |
|---|---|---|---|
| since | integer | — | — |
| source | string | — | — |
No output schema declared.
No examples provided.
iyke_open ~128
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`.
| Name | Type | Req | Description |
|---|---|---|---|
| cmd | string | — | For terminal kind. Omit for default login shell. |
| kind | string | yes | — |
| name | string | — | For mini-app kind. |
| path | string | — | For route or artifact kinds. |
| session_id | string | — | For chat kind. |
No output schema declared.
No examples provided.
iyke_query_cache ~67
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.
| Name | Type | Req | Description |
|---|---|---|---|
| pane | string | — | — |
No output schema declared.
No examples provided.
iyke_screenshot ~79
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/.
| Name | Type | Req | Description |
|---|---|---|---|
| out_path | string | — | Override default output path. |
| pane_id | string | — | Required when target=pane. |
| target | string | — | — |
No output schema declared.
No examples provided.
iyke_split ~76
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).
| Name | Type | Req | Description |
|---|---|---|---|
| direction | string | yes | — |
| pane_id | string | — | Optional. Defaults to focused pane. |
No output schema declared.
No examples provided.
iyke_state ~121
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: <recursive PaneNode> }; 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.
Input schema present but exposes no named parameters.
No output schema declared.
No examples provided.
iyke_type ~82
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.
| Name | Type | Req | Description |
|---|---|---|---|
| pane | string | — | — |
| ref | string | — | — |
| replace | boolean | — | — |
| selector | string | — | — |
| text | string | yes | — |
No output schema declared.
No examples provided.
iyke_wait ~82
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? }.
| Name | Type | Req | Description |
|---|---|---|---|
| kind | string | yes | — |
| pane | string | — | — |
| timeout_ms | integer | — | — |
| value | string | yes | — |
No output schema declared.
No examples provided.