Figure Library

Scientific Figure Library 0.9.1

Use the connected SFL tools and one user-selected global Library. The MCP App is optional: ordinary MCP tools can supply guidance, candidate thumbnails, pagination, exact previews, and materialization without loading App HTML.

For network problems, use figure_library_network_status to inspect this MCP process's same-user/machine loopback HTTP proxy setting and figure_library_network_test for a bounded check of the fixed SFL GitHub Release endpoint. Remote or container MCP processes have separate settings. figure_library_update_status reports the running version, latest stable Release cache, freshness, and exact Release link; { "refresh": true } checks manually. A new-version notice may appear as one additional text item on a successful tool result; keep the structured result authoritative. Updating is manual and requires restarting the MCP process. These three tools return the standard terminal envelope and status fields in structuredContent. Read envelope.code, terminal, and retrySameCall before acting; do not repeat a failed diagnostic unchanged. A fresh update result with cachePersisted: false is still valid for this process; report its cache warning separately instead of treating the network check as failed.

Load only the guidance needed

This is the single Skill entrypoint. Read supporting files locally, or call figure_library_get_skill with document set to their path relative to this Skill directory. Calling it with no arguments returns this file plus the available document IDs, resource URIs, hashes, service version and capabilities. Resource-capable hosts may read those URIs instead. Resolve relative links against the current document's directory; use the returned document IDs. The tool returns the same bundled text, including optional helper source; reading it does not install a Skill, execute helpers, or grant write approval.

• For binding, intake, review, publication, Provider management, backup, or recovery, read library workflows before planning a change. The tool schemas remain authoritative for parameters.
• Before creating/updating template prose, read description guidance. Keep description, application, dataProfile, and visualProfile separate.
• When the user requests adapting a selected template, read script organization and style and render checks, then only their relevant backend references. Preserve the reference style by default.
• Export diagnostics only when requested, using figure_library_export_diagnostics.

Recreate and publish templates

Use the existing description/style/organization guidance. Propose a readable English subtitle and a source-grounded scientific question; inspect the whole figure and relevant panel/legend/axis crops before and after rendering. The host runs plotting, not SFL. Use figure_library_plan_publish → one human review → figure_library_apply_publish. Default publication is local; open_module is explicit and ends at a PR. See library workflows for proposal fields and recovery. Keep provenance/execution truth in metadata, not repeated template-facing disclaimers.

Search and display candidates

1. Call figure_library_source_status when the effective Library/setup is unknown. On setup_required, use the binding workflow and ask for the missing absolute global Library and Local workspace directories. Never infer either directory from the current project. figure_library_open opens the optional App when the user requests it.
2. Search using the user's plotting goal and compact data/visual requirements. Inspect user-provided reference images with the host viewer first. Do not invent a query when the user only asks to open the library.
3. figure_library_search returns a resultSetId, provider-qualified exactSelectors, result-scoped candidateIds, thumbnail URIs and pagination. Keep these returned identities unchanged. Default Providers are Local Published, FigureYa, Open Figure Modules, then opted-in personal sources; bundled Community is frozen and explicit-only (includeInDefaultSearch: false).
4. In an App host, the component displays thumbnails. In an ordinary MCP host, read the returned thumbnail resources or call figure_library_get_candidate_images with the result set and current-page candidate IDs (at most 12). Display the returned images with their labels using the host's image support. This is thumbnail browsing, not exact preview confirmation. Do not generate replacement images.
5. Wait for user selection after presenting the page. For another page, use figure_library_search_page with the original resultSetId and opaque nextCursor; do not alter the query to simulate pagination. Never walk all candidates automatically. Explicit delegation to choose permits reviewing a small relevant subset. Do not claim the user saw images merely because the model received them; if the host cannot display them, report that limit.