Skip to main content
Glama
xuzhougeng

ScientificFigureLibrary

by xuzhougeng
OverviewSchemaSourceRelated ServersDiscussionsAdmin
TypeScript
Local

Search all matching scientific figure Providers

figure_library_search
Read-onlyIdempotent

Search multiple scientific figure libraries to find plot templates and visual references that match your query and data profile, then preselect candidates for review.

Instructions

Search Local Published, FigureYa, Open Figure Modules and opted-in personal Providers. Present candidates using host thumbnail resources/image tools or the optional App, then wait for selection. Community is explicit-only; Working, Capture and flat-v1 entries are excluded.

Input Schema

TableJSON Schema
NameRequiredDescriptionDefault
limitNo
queryYes
languageNo
assetKindNo
codeStatusNo
plotFamilyNo
dataProfileNo
providerIdsNo
resultSetIdNoPresent the exact cached result set returned by an Open Figure PR Plan; keep its query, filters, providers and limit unchanged.
reviewStatusNo
visualProfileNo

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed1 schema field changedv0.6.8
    • addedInput schema / properties / resultSetId
      Added value: +{
+  "description": "Present the exact cached result set returned by an Open Figure PR Plan; keep its query, filters, providers and limit unchanged.",
+  "maxLength": 256,
+  "minLength": 1,
+  "type": "string"
+}
  2. Changed1 schema field changedv0.4.0
    • removedInput schema / properties / providerIds / default
      Removed value: -[
-  "org.scientificfigurelibrary.local",
-  "org.figureya.module"
-]
  3. Changed9 schema fields changed
    • removedInput schema / properties / assetKind / description
      Removed value: -"Filter reusable plotting templates separately from visual-only references."
    • changedInput schema / properties / codeStatus / enum
      Previous value: -[
-  "none",
-  "scaffold",
-  "reviewed"
-]New value: +[
+  "none",
+  "scaffold",
+  "provided",
+  "reviewed"
+]
    • removedInput schema / properties / dataProfile / description
      Removed value: -"Compact shape, column/type, semantic-role, and missingness summary. No raw data."
    • addedInput schema / properties / providerIds
      Added value: +{
+  "default": [
+    "org.scientificfigurelibrary.local",
+    "org.figureya.module"
+  ],
+  "items": {
+    "maxLength": 200,
+    "minLength": 1,
+    "type": "string"
+  },
+  "maxItems": 16,
+  "minItems": 1,
+  "type": "array"
+}
    • removedInput schema / properties / query / description
      Removed value: -"Plotting intent and scientific purpose, in Chinese or English."
    • changedInput schema / properties / reviewStatus / enum
      Previous value: -[
-  "draft",
-  "approved",
-  "archived"
-]New value: +[
+  "not_reviewed",
+  "draft",
+  "approved",
+  "archived"
+]
    • removedInput schema / properties / sourceIds
      Removed value: -{
-  "default": [
-    "figureya",
-    "user"
-  ],
-  "description": "Optional source filter. By default both FigureYa and the user library are searched.",
-  "items": {
-    "enum": [
-      "figureya",
-      "user"
-    ],
-    "type": "string"
-  },
-  "maxItems": 2,
-  "minItems": 1,
-  "type": "array"
-}
    • removedInput schema / properties / visualProfile / description
      Removed value: -"Compact chart family, layout, axes, encodings, labels, and style summary."
    • changedOutput schema / (root)
      Previous value: -{
-  "$schema": "http://json-schema.org/draft-07/schema#",
-  "additionalProperties": false,
-  "properties": {
-    "candidates": {
-      "items": {
-        "additionalProperties": false,
-        "properties": {
-          "application": {
-            "type": "string"
-          },
-          "assetKind": {
-            "enum": [
-              "plot_template",
-              "visual_reference"
-            ],
-            "type": "string"
-          },
-          "codeFiles": {
-            "items": {
-              "type": "string"
-            },
-            "type": "array"
-          },
-          "codeStatus": {
-            "enum": [
-              "none",
-              "scaffold",
-              "reviewed"
-            ],
-            "type": "string"
-          },
-          "dataProfile": {
-            "type": "string"
-          },
-          "description": {
-            "type": "string"
-          },
-          "excerpt": {
-            "type": "string"
-          },
-          "inputFiles": {
-            "items": {
-              "type": "string"
-            },
-            "type": "array"
-          },
-          "language": {
-            "type": "string"
-          },
-          "license": {
-            "type": "string"
-          },
-          "management": {
-            "additionalProperties": false,
-            "properties": {
-              "adapter": {
-                "enum": [
-                  "direct",
-                  "gallery",
-                  "figure-transfer-package"
-                ],
-                "type": "string"
-              },
-              "canArchive": {
-                "type": "boolean"
-              },
-              "canUpdate": {
-                "type": "boolean"
-              },
-              "galleryId": {
-                "type": "string"
-              },
-              "identityMode": {
-                "enum": [
-                  "stable-source",
-                  "content-addressed"
-                ],
-                "type": "string"
-              },
-              "registrySourceId": {
-                "type": "string"
-              },
-              "templateId": {
-                "type": "string"
-              },
-              "updateVia": {
-                "enum": [
-                  "plan-apply",
-                  "diff-upsert",
-                  "gallery-sync"
-                ],
-                "type": "string"
-              }
-            },
-            "required": [
-              "templateId",
-              "canArchive",
-              "canUpdate"
-            ],
-            "type": "object"
-          },
-          "matchedTerms": {
-            "items": {
-              "type": "string"
-            },
-            "type": "array"
-          },
-          "materializable": {
-            "type": "boolean"
-          },
-          "packages": {
-            "items": {
-              "type": "string"
-            },
-            "type": "array"
-          },
-          "plotFamily": {
-            "type": "string"
-          },
-          "previewAvailable": {
-            "type": "boolean"
-          },
-          "previewDataUrl": {
-            "type": "string"
-          },
-          "reasons": {
-            "items": {
-              "type": "string"
-            },
-            "type": "array"
-          },
-          "reportUrl": {
-            "type": "string"
-          },
-          "retrievalScore": {
-            "type": "number"
-          },
-          "reviewStatus": {
-            "enum": [
-              "draft",
-              "approved",
-              "archived"
-            ],
-            "type": "string"
-          },
-          "sourceId": {
-            "enum": [
-              "figureya",
-              "user"
-            ],
-            "type": "string"
-          },
-          "sourceLabel": {
-            "type": "string"
-          },
-          "sourceUrl": {
-            "type": "string"
-          },
-          "templateId": {
-            "type": "string"
-          },
-          "title": {
-            "type": "string"
-          },
-          "warnings": {
-            "items": {
-              "type": "string"
-            },
-            "type": "array"
-          }
-        },
-        "required": [
-          "templateId",
-          "sourceId",
-          "sourceLabel",
-          "title",
-          "retrievalScore",
-          "matchedTerms",
-          "reasons",
-          "warnings",
-          "excerpt",
-          "description",
-          "application",
-          "dataProfile",
-          "inputFiles",
-          "codeFiles",
-          "packages",
-          "materializable",
-          "previewAvailable",
-          "assetKind",
-          "language",
-          "plotFamily",
-          "reviewStatus",
-          "codeStatus",
-          "license",
-          "management"
-        ],
-        "type": "object"
-      },
-      "type": "array"
-    },
-    "intentFamilies": {
-      "items": {
-        "type": "string"
-      },
-      "type": "array"
-    },
-    "libraryVersion": {
-      "type": "string"
-    },
-    "query": {
-      "type": "string"
-    },
-    "reviewRequired": {
-      "type": "boolean"
-    },
-    "sources": {
-      "items": {
-        "additionalProperties": false,
-        "properties": {
-          "matched": {
-            "maximum": 9007199254740991,
-            "minimum": -9007199254740991,
-            "type": "integer"
-          },
-          "sourceId": {
-            "enum": [
-              "figureya",
-              "user"
-            ],
-            "type": "string"
-          },
-          "sourceLabel": {
-            "type": "string"
-          }
-        },
-        "required": [
-          "sourceId",
-          "sourceLabel",
-          "matched"
-        ],
-        "type": "object"
-      },
-      "type": "array"
-    }
-  },
-  "required": [
-    "query",
-    "libraryVersion",
-    "intentFamilies",
-    "reviewRequired",
-    "sources",
-    "candidates"
-  ],
-  "type": "object"
-}New value: +null
  4. First observedv0.3.0

TDQS

C2.9/5.0
Behavior3/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

Annotations already declare readOnlyHint=true, idempotentHint=true, and destructiveHint=false, covering the safety profile. The description adds behavioral context about presenting candidates and waiting for selection, which is beyond annotations. However, it does not clarify any stateful behavior, side effects, or what happens after selection.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness4/5

Is the description appropriately sized, front-loaded, and free of redundancy?

Three sentences total, each adding distinct information: the search scope, the presentation behavior, and the exclusions. The structure is reasonably front-loaded, but the second sentence is slightly cumbersome with 'host thumbnail resources/image tools or the optional App' and could be tighter.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness2/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Despite moderate length, the description is incomplete relative to the tool's complexity (11 params, no output schema, no return description). It does not explain what the search results contain, how to interpret the selection wait, or what the agent should do with the output. It relies on an interactive flow that is not described, leaving too much to inference for an agent to call this effectively.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters1/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema description coverage is only 9%, so the description carries the burden for explaining 11 parameters, but the description does not mention any of them. It gives no meaning for query, limit, language, assetKind, codeStatus, plotFamily, dataProfile, visualProfile, providerIds, or resultSetId beyond the raw schema, which is nearly silent. This is a major gap for a tool with this many parameters.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose4/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description specifies the verb 'Search' and the resource (scientific figure Providers), listing the concrete provider sets included. However, it does not differentiate from closely related siblings like figure_library_search_page or figure_library_get_candidate_images, so an agent cannot immediately tell which search tool to prefer.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines3/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The description gives implied usage context by naming the included and excluded provider scopes ('Community is explicit-only; Working, Capture and flat-v1 entries are excluded'). This helps an agent decide what results will be returned, but it provides no explicit when-to-use guidance or alternative routing to sibling search tools.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

Deploy Server

Other Tools