Pinako AI Bridge

Lists all Pinako installs currently connected to this MCP server. Each entry: browserBrand (human-readable name like "Chrome" or "Brave"), browserId (stable per-install id), updatedAt (timestamp of last data update — any tree mutation, memo edit, note write, etc.), windowCount (live windows), librar…

Searches the Pinako user guide. Returns ranked sections with title, anchor id, source ("user-guide" / "ai-connect" / "import" / "agent"), excerpt, and score. Bundled with this bridge, served from local cache (~10ms, no internet). Two RESERVED single-word queries address agent-only material and match…

REPLACES the entire tag array on a node. Pass an empty array to clear all tags. Use add_tags / remove_tags for delta updates that preserve existing tags. Constraints: each tag max 50 chars; max 50 tags per node.

APPENDS tags to a node, deduping and preserving order of existing tags. Use this when the user says "tag X with Y" or "also add Z" — it preserves prior tags. Use set_tags for full replacement, remove_tags for deletion. Constraints: each tag max 50 chars; max 50 tags per node total (existing + append…

Filters specific tags off a node, preserving the rest. No-op for tags not present. Use this for "untag X from Y" requests. Constraints: each tag max 50 chars.

Sets the memo (short plain-text annotation, max 2500 chars) on a node. Pass empty string to clear. Memos are per-node and concise; for richer rich-text documents use create_note / set_note_content (which target a library or the Main Notes, not individual nodes). The memo content field is named "text…

Sets the row star color on a node. Accepts a named color (red, orange, yellow, green, blue, purple) OR its exact hex equivalent (#ff4d4f red, #fa8c16 orange, #fadb14 yellow, #52c41a green, #1890ff blue, #722ed1 purple). Arbitrary hex codes are NOT accepted — only the six pre-defined hex values. Pass…

Sets the rowColor of a Window Group node or Folder node. NOT related to browser Tab Group color (a Tab Group's color is Chrome identity — use update_tab_group for that; tabgroup nodes are rejected here with INVALID_NODE_TYPE). Accepts: "accent2" (theme-tracking default), a named color ("blue", "red"…

Sets a custom title on a tab, window, Window Group (type="group"), or folder node. Trimmed; max 200 chars. Sets customTitle=true so the title persists across browser restarts. Rejects tabgroup nodes with INVALID_TARGET (a Tab Group name is Chrome-coupled identity, not a customTitle overlay — use upd…

Moves a node and its FULL subtree under newParentId (null = root, which auto-wraps a tab into a new window). To move a node WITHOUT its children, outdent its FIRST child first (sibling-adoption pulls the rest under it), then move the now-empty target — or wrap both in one bulk_apply. VALID PARENT BY…

Moves a node and its FULL subtree OUT of one Library and INTO another (libraryId -> targetLibraryId). This is the ONLY tool that can cross a Library boundary in one step; move_node with scope:"library" moves within a single library and rejects a foreign destination. Both libraries change atomically,…

Creates a new Window Group node (type="group" — Pinako's organizational row for nesting windows). Window Groups can contain other Window Groups and windows but NOT tabs directly (tabs always live under a window, a tabgroup node, or another tab). Position defaults to TOP of the destination siblings (…

Creates a new window node by RELOCATING one or more existing tabs into it (tabIds, at least one; an empty window is invalid). Bundles loose tabs into a window in ONE atomic step instead of moving tabs to root one at a time. Scope "tree" (default) or "library" (libraryId required); NOT bookmarks. par…

Creates a NEW browser Tab Group (the colored, named chip in the browser tab strip) by RELOCATING one or more existing tabs into a new type="tabgroup" node — create_window's contract one level down. The group forms in the FIRST listed tab's window, at that tab's position; tabs listed from OTHER windo…

Edits a browser Tab Group's identity: title (rename; empty string "" clears back to untitled), color (Chrome's 9-color enum), and/or collapsed. At least one field required. This is the ONLY tool for tabgroup identity — set_title and set_row_color reject tabgroup nodes by design. LIVE groups: the cha…

Dissolves a browser Tab Group: member tabs stay open (or stay saved, for a closed group) and keep their tree position — promoted in place where the group row was — and the group node is removed. Mirrors the UI's "Ungroup (keep tabs open)". NOT a delete: nothing closes and no data is lost, so no conf…

DESTRUCTIVE — permanently removes a GHOST node (chromeId=null) and its metadata (tags/memos/colors/title); for scope="bookmarks", removes the browser bookmark via chrome.bookmarks.remove. REFUSES subtrees containing any live tab (LIVE_NODE_REFUSED) — ghost_node first, then delete_node, or use delete…

Closes the live browser tab(s) for this node and all live descendants, while preserving the tree node with chromeId=null on every ghosted node. Mirrors the manual "X" button. REVERSIBLE: the user can re-open from the tree later (URLs and metadata stay in the tree). Use this for "close these tabs but…

DESTRUCTIVE — closes the live browser tab(s) AND removes the tree node entirely (compound of ghost_node + delete_node, but bypasses delete_node's LIVE_NODE_REFUSED). Use when the user wants both the browser tabs gone AND the saved tree node gone. Mirrors the manual trash button on live nodes. SCOPE …

Nests a node under its previous sibling (one level deeper). Rejects when the node has no prior sibling (INDENT_NO_PREV_SIBLING). Auto-expands the new parent. Works across tree, library, and bookmark scopes — a common pattern for quickly de-nesting then re-organizing tabs. For scope="bookmarks", the …

Promotes a node to its grandparent's level (one level shallower). Sibling-adoption preserves layout: the outdented node's younger siblings become its children, so visual row order is preserved. CHILD-EXTRACTION PATTERN: outdent the FIRST child of a target to free the target solo (target becomes empt…

Creates a new empty library with an auto-seeded "Notes" note. Returns createdLibraryId and createdNoteId in the result. Use add_to_library afterwards to populate. For just creating an organizational umbrella over EXISTING libraries, use create_library_group instead. NOT IDEMPOTENT: each call creates…

Clones TREE nodes (windows/tabs/groups/folders) from a source surface into a library. Pass only source TREE ids (e.g. children[] from get_library), NOT note ids from notes[] (those will not resolve — duplicate a note via create_note instead). includeChildren default TRUE (subtree comes along, matchi…

Clones tree or library nodes INTO the browser bookmark tree (inverse of add_to_library). "save tab X as a bookmark" / "back up these to bookmarks" → this tool; "MOVE to bookmarks" → this tool then delete_node on the source (no atomic move in v1). sourceScope "tree" (default) or "library" (sourceLibr…

Updates an existing note. mode "replace" (default) overwrites; "append" concatenates (the FINAL combined length is what's tier-gated: 50K Pro / 150K Pro+ / 250K Premium / 500K Enterprise). For prepend, read first then replace with the combined string. Content is sanitized (script / on* / javascript:…

Creates a new note in a library or in the Main Notes. Use this when the user says "create a note about X", "save these findings as a new note", etc. For UPDATING an existing note, use set_note_content. Returns createdNoteId. Char limit is tier-gated. Note content is sanitized at write time (HTML all…

Permanently deletes a note from a library or the main tree. Cloud-side delete is automatic on next persist (the per-scope notes sync diffs current ids against existing Supabase rows and removes missing ones). LAST-NOTE BEHAVIOR: this op allows deleting any note including the only note in a scope. Pi…

Creates a new library group (an organizational umbrella over multiple libraries). Returns createdGroupId. After creating, use add_library_to_group to add member libraries. NOT IDEMPOTENT: each call creates a new group. On transient failures, DO NOT auto-retry — call list_libraries to inspect existin…

Removes a library group. TWO MODES via cascadeMembers: (1) DEFAULT (cascadeMembers omitted/false) — DISSOLVE: member libraries are KEPT and re-appear in the standalone library card list at the position the group occupied. Safe; non-destructive. (2) cascadeMembers:true — DESTRUCTIVE: also deletes eac…

Adds an existing library to an existing group. A library can belong to at most one group; rejects with LIBRARY_ALREADY_IN_GROUP / LIBRARY_IN_OTHER_GROUP if it's already assigned somewhere.

Removes a library from a group, returning it to the standalone library card list right after the group. The library itself is preserved. No-op if the library wasn't in the group (removing a stale ref is valid cleanup).

Renames a library group. Trimmed, non-empty, max 200 chars.

Updates a library group's description. Empty string clears it. Max 1000 chars.

Renames a library. Trimmed, non-empty, max 200 chars. THIS IS THE ONLY rename path for a library (the container) — set_title rejects the library container with INVALID_TARGET (the library root is type 'library', not a renamable tree node; in-library FOLDER nodes, type 'library-folder', ARE renamable…

Updates a library's description (shown beneath the title on library cards). Empty string clears it. Max 1000 chars. Mirrors set_library_group_description for the umbrella-group case.

Permanently deletes a single library and ALL its content (tabs, notes, tags, memos, child windows/groups/folders). Removes the library from any group it belongs to AND from the panel order. DESTRUCTIVE: cannot be fully undone — Ctrl+Z restores the libraryData entry but does NOT restore the group/pan…

Reorders the cards in the library panel (standalone library cards + library group cards). Pass the COMPLETE current list of entries in the desired order. Each entry is {type:"library"|"group", id:<id>}. ORDER ONLY — every existing entry must be present (rejects with PANEL_ORDER_MISMATCH if count dif…

Creates a new folder node in a library or in the browser bookmarks. NOT for the main tab tree (the main tree uses windows + groups, not folders). Required scope: "library" (with libraryId) or "bookmarks". Default position is TOP of the parent (matches manual UI). For bookmarks, the folder is also cr…

Reorders the libraries within a single library group. Pass the COMPLETE current list of member library ids in the desired order. ORDER ONLY — every current member must be present (rejects with LIBRARY_ORDER_MISMATCH if count differs, LIBRARY_ORDER_UNKNOWN_MEMBER if an unknown id is introduced, LIBRA…