Pinako AI Bridge

by teleomorph

Not rated
GitHub

About

Pinako AI Bridge connects your browser tabs, bookmarks, Pinako libraries and notes to Claude, Cursor, and other desktop AI clients, so your agent can query them, organize them, and move information between Pinako and your other tools and services.

Details

Author
teleomorph
Categories
Productivity, Other, AI

Setup

Install Pinako AI Bridge in your MCP client (Claude Desktop, Cursor, Windsurf, and others).

Repository: https://github.com/teleomorph/pinako-mcp

Follow the installation instructions in the repository README, then restart your MCP client.

Pinako AI Bridge connects your browser tabs, bookmarks, Pinako libraries and notes to Claude, Cursor, and other desktop AI clients, so your agent can query them, organize them, and move information between Pinako and your other tools and services.

Connect your browser tabs and libraries to Claude Desktop, Cursor, and everything else your AI can reach.

The Model Context Protocol (MCP) bridge that connectsPinako— a Chromium extension for tab tree management — to local AI clients including Claude Code, Claude Desktop, Cursor, ChatGPT-Codex, VS Code (Copilot agent mode), Antigravity, Grok Build, Kimi Code, OpenClaw, Hermes, Cline, Zoo Code, and any HTTP MCP client. Legacy installs of Windsurf, Roo Code, Continue.dev, and Gemini CLI are also configured when present.

The bridge runs as a small native messaging host on your computer and exposes your Pinako tab tree, libraries, library groups, Main Notes, and browser bookmarks as MCP tools. It is a fullread and writesurface: your AI assistant can both query your browser state and reorganize it — move and nest tabs, create libraries, groups, and folders, edit titles, tags, memos, colors, and notes, find and remove duplicates, and apply large batched edits as a single undoable step.

Because the bridge runs inside desktop AI clients like Claude Desktop, Cursor, and Codex, the same assistant can move information between Pinako and the other tools, files, and services it connects to. For example:

- "Copy this research library's notes into a Google Doc."
- "Build a spreadsheet from the tabs in my Competitors library."
- "Visit the URLs in my Reading library and write up a summary."
- "Organize my open tabs into libraries by topic, then tag the work ones."
- "Find and remove my duplicate bookmarks."

Writes go through the same tier gating, confirmation, and undo machinery as the extension's own UI. Destructive operations (deletes, bookmark reorders) return aCONFIRMATION_REQUIREDresult until the caller explicitly confirms, and abulk_applybatch applies atomically as one undo step. Every write returns a structured{ok, error}result so clients can branch on the error code.

Read and write MCP tools. Full per-tool reference with parameters:pinako.pro/docs/ai-connect.

Read— query the tree, libraries, notes, and bookmarks, and search

get_tree,get_tree_summary,search_tabs,search_pinako,search_docs,list_libraries,get_library,get_main_tree_notes,get_bookmarks,list_browsers,find_duplicates

Tree structure— move, nest, group, and remove nodes

move_node,indent_node,outdent_node,create_group,create_folder,ghost_node,delete_node,delete_live_node,bulk_apply(up to 250 atomic sub-ops, undoable as one step)

Node metadata— titles, tags, memos, colors

set_title,set_tags,add_tags,remove_tags,set_memo,set_star_color,set_row_color

Libraries and library groups— create, edit, delete, and arrange

create_library,add_to_library,set_library_title,set_library_description,delete_library,create_library_group,set_library_group_title,set_library_group_description,delete_library_group,add_library_to_group,remove_library_from_group,reorder_library_panel,reorder_libraries_in_group

Notes— create and edit Main Notes and library notes

create_note,set_note_content,delete_note

Bookmarks— write to the browser bookmark tree

add_to_bookmarks(bookmark reads useget_bookmarks; dedup usesfind_duplicates)

The read tools are safe to auto-approve. Write tools are individually annotated (idempotent, non-idempotent, or destructive) so MCP clients can gate them appropriately.

Setup guide with screenshots and per-client instructions:pinako.pro/docs/ai-connect

- Windows— graphical installer (.exe)
- Linux x64andLinux ARM64— CLI installer

- Pinako extension installed in your browser (Chrome Web Store)
- An active Pinako subscription (Pro or higher) — the bridge is gated by subscription

git clone https://github.com/teleomorph/pinako-mcp.git cd pinako-mcp npm install node setup/build.js --all

Outputs land indist/. Seesetup/build.jsfor build flags (--all,--no-tauri,--no-cli).

The Tauri GUI installer can only be built on the platform it targets (i.e. build the Windows installer on Windows). The CLI installer cross-compiles for all listed platforms from any host.

- host.js— MCP server / Chrome native messaging host
- setup/main.js— CLI installer (writes the native messaging host JSON, configures supported AI clients)
- setup/build.js— multi-stage build (esbuild → pkg → Tauri)
- installer/src-tauri/— Rust Tauri GUI installer for Windows

The Laxis MCP Server connects Laxis - the AI meeting note taker and voice dictation tool for professionals to Claude and other AI tools through the Model Context Protocol. Your assistant can search and read your meeting transcripts, summaries, and participants directly in chat — turning every conversation you've recorded into context your AI can reason over.

Give me a one - two sentence description of the BCMS MCP # MCP The BCMS Model Context Protocol (MCP) integration enables AI assistants like Claude, Cursor, and other MCP-compatible tools to interact directly with your BCMS content. This allows you to create, read, and update content entries, manage media files, and explore your content structure—all through natural language conversations with AI. ## What is MCP? The Model Context Protocol (MCP) is an open standard developed by Anthropic that allows AI applications to securely connect to external data sources and tools. With BCMS MCP support, you can leverage AI assistants to: - Query and explore your content structure - Create new content entries with AI-generated content - Update existing entries - Manage your media library - Get intelligent suggestions based on your content model --- ## Getting Started ### Prerequisites 1. A BCMS account with an active instance 2. An MCP key with appropriate permissions 3. An MCP-compatible client (Claude Desktop, Cursor, or any MCP client) ### Step 1: Create an MCP Key 1. Navigate to your BCMS dashboard 2. Go to Settings → MCP 3. Click Create MCP Key 4. Configure the permissions for templates you want the AI to access:GET: Read entries 5. POST: Create entries 6. PUT: Update entries 7. DELETE: Delete entries Note: Right now, MCP only supports creating, reading and updating content. ### Step 2: Configure Your MCP Client You can find full instructions for integrating BCMS with your AI tools right inside BCMS, on the MCP page. But in general, installing BCMS MCP works in a standard way: `` { "mcpServers": { "bcms": { "url": "https://app.thebcms.com/api/v3/mcp?mcpKey=YOUR_MCP_KEY" } } } ` ## Available Tools Once connected, your AI assistant will have access to the following tools based on your MCP key permissions: ### Content Discovery #### list_templates_and_entries Lists all templates and their entries that you have access to. This is typically the first tool to call when exploring your BCMS content. Returns: - Template IDs, names, and slugs - Entry IDs with titles and slugs for each language Example prompt: "Show me all the templates and entries in my BCMS" --- ### Entry Management #### list_entries_for_{templateId} Retrieves all entries for a specific template with full content data. A separate tool is generated for each template you have access to. Returns: - Complete entry data including all meta fields - Content in all configured languages - Entry statuses Example prompt: "List all blog posts from my Blog template" --- #### create_entry_for_{templateId} Creates a new entry for a specific template. The input schema is dynamically generated based on your template's field structure. Input: - statuses: Array of status assignments per language - meta: Array of metadata for each language (title, slug, custom fields) - content: Array of content nodes for each language Example prompt: "Create a new blog post titled 'Getting Started with BCMS' with a brief introduction paragraph" --- #### update_entry_for_{templateId} Updates an existing entry for a specific language. Input: - entryId: The ID of the entry to update - lng: Language code (e.g., "en") - status: Optional status ID - meta: Updated metadata - content: Updated content nodes Example prompt: "Update the introduction paragraph of my 'Getting Started' blog post" --- ### Media Management #### list_all_media Lists all media files in your media library. Returns: - Media IDs, names, and types - File metadata (size, dimensions for images) - Parent directory information Example prompt: "Show me all images in my media library" --- #### list_media_dirs Lists the directory structure of your media library. Returns: - Hierarchical directory structure - Directory IDs and names Example prompt: "Show me the folder structure of my media library" --- #### create-media-directory Creates a new directory in your media library. Input: - name: Name of the directory - parentId: Optional parent directory ID (root if not specified) Example prompt: "Create a new folder called 'Blog Images' in my media library" --- #### request-upload-media-url Returns a URL you use to upload a file (for example via POST with multipart form data), which avoids pushing large binaries through the MCP tool payload. You still need a valid file name and MIME type when uploading, as described in the tool response. Availability: Only when the MCP key has Can mutate media enabled. Example prompt: “Give me an upload URL for a new hero image, then tell me how to upload it.” Input: - fileName: Name of the file with extension - fileData: Base64-encoded file data (with data URI prefix) - parentId: Optional parent directory ID Example prompt: "Upload this image to my Blog Images folder" --- ### Linking Tools #### get_entry_pointer_link Generates an internal BCMS link to an entry for use in content. Input: - entryId: The ID of the entry to link to Returns: - Internal link format: entry:{entryId}@_{templateId}:entry Example prompt: "Get me the internal link for the 'About Us' page entry" --- #### get_media_pointer_link Generates an internal BCMS link to a media item for use in content. Input: - mediaId: The ID of the media item Returns: - Internal link format: media:{mediaId}@_@*_:entry Example prompt: "Get the link for the hero image so I can use it in my blog post" --- ## Content Structure ### Entry Content Nodes When creating or updating entries, content is structured as an array of nodes. Supported node types include: Type Description paragraph Standard text paragraph heading Heading (h1-h6) bulletList Unordered list orderedList Numbered list listItem List item codeBlock Code block with syntax highlighting blockquote Quote block image Image node widget Custom widget with props ### Example Content Structure ` { "content": [ { "lng": "en", "nodes": [ { "type": "heading", "attrs": { "level": 1 }, "content": [ { "type": "text", "text": "Welcome to BCMS" } ] }, { "type": "paragraph", "content": [ { "type": "text", "text": "This is your first paragraph." } ] } ] } ] } `` ## Security & Permissions ### MCP Key Scopes Your MCP key controls what the AI can access: - Template Access: Only templates explicitly granted in the MCP key are visible - Operation Permissions: Each template can have independent GET/POST/PUT/DELETE permissions - Media Access: Media operations are controlled separately ### Best Practices 1. Principle of Least Privilege: Only grant the permissions needed for your use case 2. Separate Keys: Create different MCP keys for different purposes or team members 3. Regular Rotation: Periodically rotate your MCP keys ## Use Cases ### Content Creation Workflows Blog Post Creation "Create a new blog post about the benefits of headless CMS. Include an introduction, three main benefits with explanations, and a conclusion. Use the Blog template." Product Updates "Update the price field for all products in the Electronics category to apply a 10% discount" ### Content Exploration Content Audit "List all blog posts that don't have a featured image set" Translation Status "Show me which entries are missing German translations" ### Media Organization Library Cleanup "Show me all unused images in the media library" Folder Setup "Create folder structure for: Products > Categories > Electronics, Clothing, Home" ## Troubleshooting ### Common Issues #### "MCP key not found" - Verify your MCP key format: keyId.keySecret.instanceId - Ensure the MCP key hasn't been deleted or deactivated - Check that you're using the correct instance #### "MCP key does not have access to template" - Review your MCP key permissions in the dashboard - Ensure the required operation (GET/POST/PUT/DELETE) is enabled for the template #### Session Expired - MCP sessions may timeout after periods of inactivity - Simply start a new conversation to establish a fresh session ### Getting Help - Documentation: thebcms.com/docs - Support: support@thebcms.com - Community: Join BCMS Discord for community support ## Technical Reference ### Endpoint POST https://app.thebcms.com/api/v3/mcp?mcpKey={MCP_KEY} ### Transport BCMS MCP uses the Streamable HTTP transport with session management. Sessions are maintained via the mcp-session-id header. ### Response Format All tools return structured JSON responses conforming to the MCP specification with: - content: Array of content blocks - structuredContent: Typed response data ## Rate Limits MCP requests are subject to the same rate limits as API requests: - Requests are tracked per MCP key - Contact support if you need higher limits for production workloads

Persistent memory for any AI assistant. Zero token cost until recall. Stores memories in local SQLite, ranks by 6-factor scoring, returns results 79% smaller than JSON. Works with Claude, ChatGPT, Grok, Cursor, Windsurf, and any MCP client.

After Effects MCP is a full-featured automation bridge that connects AI clients (like VS Code, Claude Desktop, and Claude Code) to Adobe After Effects through MCP, enabling scripted control of compositions, layers, effects, keyframes/graph easing, presets, markers, audio levels, waveform analysis, and effect discovery via a live bridge panel.

Project management your AI can actually run — connect Claude, ChatGPT, Cursor & Codex to one board over MCP.

AIOProductOS spine over MCP — customers, revenue, feedback, work, analytics on one typed record.

The memory layer for AI coding tools. Local-first, semantic, 9 MCP tools with consolidation and project scoping. Works with Claude Code, Cursor, Windsurf & any MCP client.

One MCP server for Claude, ChatGPT & Gemini — wraps your ERPs, CRMs, APIs and knowledge base into a single governed endpoint.

Run your field service business from Claude: answer calls, book and dispatch jobs, build estimates, chase invoices. Built for HVAC, plumbing, electrical, roofing and pest control.

Complete Swiss accounting integration for Bexio via MCP. Works with Claude Desktop, n8n, and any MCP client. 221 tools for invoices, contacts, projects & more.

No reviews yet — be the first

Sign in to leave a review

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.