Connect and get to work.
Use helfa through an AI client that supports remote MCP servers.
- Sign in and complete any required setup.
- Add this server URL in the client MCP connection settings:
https://helfa.ai/mcp
- Approve the permissions in your browser.
- Ask your client to list the available tools.
Tools
Upload a file image
Upload PNG, JPEG, or WebP base64 bytes to one owned file. Use the same assetId for retries. At most 750000 bytes and four million pixels; no SVG or animated images. Returns an assetId for explicit document and slide image operations. Images are retained for saved history and undo.
Read a visual review
Return an actual PNG image and layout findings for a completed document or slide review. Requires fileId and reviewId. Rejects expired and outdated revisions. Inspect the image and correct problems before reporting completion.
Read file build requirements
Before building a spreadsheet, document, or slides, read the matching requirements. Returns schemas, supported operations, limits, and review checks. The connected AI designs the content and layout; Helfa validates and executes explicit operations.
List files
Find your documents, spreadsheets, and slide decks. Returns metadata and open links, not formula caches.
Check editor connection
Check whether this exact file has an active editor connection, without opening a view or changing the file. Call after helfa_show_editor and when editing reports editor_required. The embedded side panel is sufficient. If not connected yet, wait briefly and check again. Use typed Helfa tools, never computer control. Do not create a replacement file.
Open a file
Read file metadata, revision, and editor connection status. This tool does not activate an editor. Use helfa_show_editor with this fileId to open the embedded side panel, then helfa_editor_status to check its connection. The URL is only for hosts without embedded apps. Do not open an extra tab or use computer control when a side panel is available.
Create a file
Create one blank owned file. Reuse fileId when retrying creation or recovering an editor connection. Call helfa_show_editor with this fileId to open it in the side panel, then helfa_editor_status. A created file is not yet a connected editor. Do not create another file, open an extra browser tab, or use computer control to recover.
Check an operation
Check a pending operation. Only status completed with saved true confirms an edit was stored. Do not resubmit with a new operation ID after an uncertain response.
Read file history
List saved revisions and their source. Browser calculation results are not independently verified by the server.
helfa inspect desktop
Inspect the browser desktop containing fileId: open windows, exact file IDs, active window, geometry, save and connection state. Requires that file to be open in a Helfa desktop window. A standalone or embedded editor returns desktop_required. Content edits target each fileId independently. Requires an open signed-in editor. Returns a pending operation ID; poll helfa_operation_status. Never report a pending operation as complete.
helfa control desktop
Open, focus, minimize, maximize, restore, move, resize, or tile desktop windows. fileId identifies an already connected desktop editor used to deliver the command; windowId is the target file UUID, files, or connect. Supply bounds for move/resize, no windowId for tile, and a new operationId. This changes window state only; it does not edit or save file content. Check helfa_editor_status for newly opened files before editing. Closing windows remains a user action. Requires an open signed-in editor. Returns a pending operation ID; poll helfa_operation_status. Never report a pending operation as complete.
helfa review desktop
Capture the real visible browser desktop or a visible windowId. fileId is the connected desktop editor that carries this request; expectedRevision is that file's saved revision. Then call helfa_get_review with the returned reviewId to inspect the PNG. This is an overview, not proof that all pictured files are saved or current. Use each file's content reads and specific review tools to verify its result. Requires an open signed-in editor. Returns a pending operation ID; poll helfa_operation_status. Never report a pending operation as complete.
helfa review document
Capture selected document blocks at a declared width and saved revision. Supply blockIds and optional offsetY for long sections. These are block captures, not pages. Then use helfa_get_review to receive and inspect the image. Requires an open signed-in editor. Returns a pending operation ID; poll helfa_operation_status. Never report a pending operation as complete.
helfa review slides
Capture one native slide at its saved revision and measure layout. Supply slideId. Then use helfa_get_review to receive and inspect the image and findings. Requires an open signed-in editor. Returns a pending operation ID; poll helfa_operation_status. Never report a pending operation as complete.
helfa validate build plan
Validate explicit operations against the open file without applying or saving them. Read the file first to initialize native IDs and obtain its revision. The file type determines the operation schema. Correct errors, then use the matching edit tool with this revision and a new operationId. Validation does not reserve a revision or establish factual or visual correctness. Requires an open signed-in editor. Returns a pending operation ID; poll helfa_operation_status. Never report a pending operation as complete.
helfa read document
Read document blocks from the open editor. Use bounded pages. Requires an open signed-in editor. Returns a pending operation ID; poll helfa_operation_status. Never report a pending operation as complete.
helfa edit document
Apply typed document changes. Read first and use the returned revision. Requires an open signed-in editor. Returns a pending operation ID; poll helfa_operation_status. Never report a pending operation as complete.
helfa undo document edit
Undo a saved document edit if no later edit would be lost. Requires an open signed-in editor. Returns a pending operation ID; poll helfa_operation_status. Never report a pending operation as complete.
helfa read slides
Read slide elements from the open editor. Use bounded pages. Requires an open signed-in editor. Returns a pending operation ID; poll helfa_operation_status. Never report a pending operation as complete.
helfa edit slides
Apply typed slide changes. Read first and use the returned revision. Requires an open signed-in editor. Returns a pending operation ID; poll helfa_operation_status. Never report a pending operation as complete.
helfa undo slides edit
Undo a saved slide edit if no later edit would be lost. Requires an open signed-in editor. Returns a pending operation ID; poll helfa_operation_status. Never report a pending operation as complete.
helfa read spreadsheet
Read workbook structure, automations, or a bounded cell range with formula errors. Use includeFormatting with a range to inspect styles, dimensions, and frozen headings (at most 1,000 cells). Formula results come from the browser calculation engine. Requires an open signed-in editor. Returns a pending operation ID; poll helfa_operation_status. Never report a pending operation as complete.
helfa edit spreadsheet
Apply explicit worksheet, formula, layout, and style operations. Before building, call helfa_get_build_requirements and design the plan in the connected AI. Validate it with helfa_validate_build_plan. Supply formulas, not claimed results. Read first and use the returned revision. After saving, read results and includeFormatting to review them. Requires an open signed-in editor. Returns a pending operation ID; poll helfa_operation_status. Never report a pending operation as complete.
helfa save automation
Save a reusable automation of typed operations. Arbitrary code is not accepted. Requires an open signed-in editor. Returns a pending operation ID; poll helfa_operation_status. Never report a pending operation as complete.
helfa run automation
Run a saved automation in the browser engine with checked parameters. Requires an open signed-in editor. Returns a pending operation ID; poll helfa_operation_status. Never report a pending operation as complete.
helfa undo spreadsheet edit
Undo a saved spreadsheet edit if no later edit would be lost. Requires an open signed-in editor. Returns a pending operation ID; poll helfa_operation_status. Never report a pending operation as complete.
If a connection fails
Check the server URL and sign in with the correct account. If a tool needs a permission you have not approved, reconnect your client. Manage or remove connections from your account.