Skip to main content
A reference guide for all tools available in the Bifocal MCP server.

​
Projects

list_projects — Shows all your Bifocal projects. A good starting point when the agent needs to know which project to work in. create_project — Creates a new Bifocal project. The agent will ask you for a project name and any background context (e.g. a PRD or research goals) before creating it. update_project — Updates a project’s name or description. Useful when your research focus or goals have changed.

​
Insights & Feedback

get_insights — Retrieves all insights extracted from your feedback, ranked by how often they were mentioned. This is how the agent understands what your users are struggling with before generating solutions. get_quotes — Retrieves raw quotes from feedback sessions, optionally filtered by a specific insight. Useful when you want to see the exact words users said. add_feedback — Adds a feedback session to a project. You can pass plain text (e.g. a transcript you’ve pasted) or a path to a PDF file. Bifocal will process it and extract insights.

​
Contexts

create_context — Adds reference material to a project — things like your design system, brand guidelines, or product docs. Contexts can be attached to solutions to make sure generated prototypes stay on-brand. get_contexts — Lists all contexts attached to a project.

​
Solutions

generate_solution — Generates a new solution based on insights you select. The agent will ask which insights to prioritize, what your goal is, and any constraints before generating. Waits until the solution is ready before responding. create_solution — Lets the agent create a fully-specified solution directly, without using Bifocal’s generator. Used when the agent already has a clear idea of what the solution should look like. update_solution — Updates fields on an existing solution (e.g. title, brief, interventions). get_solutions — Lists all solutions for a project, or returns full detail for a specific solution including all interventions and the pages they affect.

​
Prototypes

generate_prototype — Builds a prototype from a solution using Bifocal’s coding agent, or starts a local build flow for your own coding agent. Waits until the prototype is ready before responding. update_prototype — Applies an edit to an existing prototype (e.g. “change the CTA copy on step 13”). Waits until the update is complete. get_prototypes — Lists all prototypes for a project, or returns full detail for a specific prototype including its sitemap (all pages and their paths). import_prototype — Uploads a locally built ZIP file as a prototype. The tool description includes full step-by-step instructions for preparing the ZIP from any platform (Claude Code, Cursor, Lovable, Figma Make, etc.). export_prototype — Downloads the source code of a prototype as a ZIP so you or the agent can edit it locally. screenshot_prototype — Captures a screenshot of any page in a prototype and renders it inline in the conversation. Supports interaction steps (click, hover, type, select) to capture specific UI states like a modal open or a tab selected.

​
Resources

bifocal://primer — A readable resource (not a tool) that explains what Bifocal is, how the data model works (project → insights → solution → prototype), and how to use the tools together. Agents read this automatically when they first connect.