Appearance
Agents
The desktop application can be driven by agents (Claude Code and other clients of the Model Context Protocol). An agent works on the same documents, views and windows as you: when it opens a file, encodes, builds a cohort or opens a view, the change shows at once in every window, and every action is written to the log. It can also look at what a view shows: it asks for a picture of it.
Enabling the server
In Settings, Agents, turn on Let agents connect. The application then serves MCP over HTTP at http://127.0.0.1:7417/mcp (the port can be changed), and the status bar shows Agents, lit while an agent is working.
- The server listens only on this computer (
127.0.0.1). - Every request must carry the token of the settings (
Authorization: Bearer <token>). Anyone with it can drive the application while the server runs; make a new one to disconnect every agent. - An agent writes files freely only in the folders of the open documents (and of the workspace); elsewhere the application asks you first. Opening a workspace over documents with unsaved changes asks you too.
Connecting an agent
The settings page shows the exact command, with your port and token. For Claude Code:
sh
claude mcp add --transport http furca http://127.0.0.1:7417/mcp \
--header "Authorization: Bearer <token>"Other clients take a Streamable HTTP server with a header, for example:
json
{
"mcpServers": {
"furca": {
"type": "http",
"url": "http://127.0.0.1:7417/mcp",
"headers": { "Authorization": "Bearer <token>" }
}
}
}The application must be open and the server enabled while the agent works.
Tools
| Tool | What it does |
|---|---|
list_documents | The open documents (vessels, encodings, cohorts) with their ids and key figures. |
get_document | Everything about one document: surface, encoding diagnostics, encoder parameters, cohort, selected section. |
get_summary | The report of a document, as the command line prints it. |
open_files | Opens surfaces, encodings, shape models or folders. |
close_document, set_active_document | Closes a document; makes one active. |
set_parameters | Changes encoder parameters (merged into the current ones; the layout of the parameter files). |
encode | Encodes a vessel and returns its diagnostics. |
select_section | Selects a cross-section (the linked views follow) and returns it. |
get_profiles | Radius, tilt, fold and error along the vessel. |
get_wall_map | A quantity on the wall unrolled, as a grid of numbers. |
create_cohort | Builds a cohort from open vessels; its views open. |
get_cohort, set_cohort_shape | A cohort's subjects, scores and explained variance; the shape and subject its views show. |
save_document | Saves an encoding or a cohort's shape model (.furca). |
export_surface, export_volume_mesh, export_cohort_shape | Writes a surface, an o-grid volume mesh or a shape of a cohort's model. |
list_windows, list_views | The windows, and the views of a window with their settings. |
set_lobe_degree | Shows the saccular lobes of a vessel up to a degree of their harmonics, in every view. |
open_view, close_view | Opens a view (3D, wall map, section, profiles, lobe, shape model, scores) or closes one. |
capture | A picture (PNG) of a view or of a whole window: what you see. |
save_workspace, open_workspace | Saves or opens a workspace. |
get_log | The latest messages of the log. |
Positions along a vessel are τ (about 0 to 1) and angles θ are in radians; lengths are in the units of the input mesh, and errors are relative to the mean radius, as in the rest of furca.
An example
Asked "open the aortas in data/vmr/aorta-descending, build a cohort and show me how its first mode changes the shape", an agent calls open_files with the folder, create_cohort with the new documents, then set_cohort_shape at −2 and +2 standard deviations of the first mode, with a capture of the shape model view after each, and describes what changes. You watch it happen in the application, and can take over at any moment.