Skip to content

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 ​

ToolWhat it does
list_documentsThe open documents (vessels, encodings, cohorts) with their ids and key figures.
get_documentEverything about one document: surface, encoding diagnostics, encoder parameters, cohort, selected section.
get_summaryThe report of a document, as the command line prints it.
open_filesOpens surfaces, encodings, shape models or folders.
close_document, set_active_documentCloses a document; makes one active.
set_parametersChanges encoder parameters (merged into the current ones; the layout of the parameter files).
encodeEncodes a vessel and returns its diagnostics.
select_sectionSelects a cross-section (the linked views follow) and returns it.
get_profilesRadius, tilt, fold and error along the vessel.
get_wall_mapA quantity on the wall unrolled, as a grid of numbers.
create_cohortBuilds a cohort from open vessels; its views open.
get_cohort, set_cohort_shapeA cohort's subjects, scores and explained variance; the shape and subject its views show.
save_documentSaves an encoding or a cohort's shape model (.furca).
export_surface, export_volume_mesh, export_cohort_shapeWrites a surface, an o-grid volume mesh or a shape of a cohort's model.
list_windows, list_viewsThe windows, and the views of a window with their settings.
set_lobe_degreeShows the saccular lobes of a vessel up to a degree of their harmonics, in every view.
open_view, close_viewOpens a view (3D, wall map, section, profiles, lobe, shape model, scores) or closes one.
captureA picture (PNG) of a view or of a whole window: what you see.
save_workspace, open_workspaceSaves or opens a workspace.
get_logThe 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.

furca — parametric models of blood vessels.