Skip to main content
Glama

search_biomedical_images

Read-onlyIdempotent

Retrieve biomedical images from NLM Open-i with URLs and metadata. Supports filtering by image type, collection, and license.

Instructions

πŸ–ΌοΈ Search biomedical images from NLM Open-i.

Searches medical/scientific images from Open-i and returns image URLs with metadata (caption, article info, MeSH terms).

═══════════════════════════════════════════════════════════════ ⚠️ CRITICAL - LANGUAGE REQUIREMENT: ═══════════════════════════════════════════════════════════ Open-i ONLY supports English queries. If the user queries in non-English (Chinese, Japanese, Korean, etc.), you MUST:

  1. Translate the query to English medical terminology first

  2. Then call this tool with the English query Example: "ε–‰ι ­ζ°΄θ…«" β†’ "laryngeal edema" "胸部Xε…‰θ‚Ίη‚Ž" β†’ "chest X-ray pneumonia"

The tool has built-in translation hints for common CJK medical terms, but YOU should always verify the translation is correct.

═══════════════════════════════════════════════════════════ SOURCES: ═══════════════════════════════════════════════════════════════

  • Open-i (NLM): X-ray, microscopy, clinical images

═══════════════════════════════════════════════════════════════ EXAMPLES: ═══════════════════════════════════════════════════════════════

General image search: search_biomedical_images("chest pneumonia CT scan")

X-ray only: search_biomedical_images("fracture", image_type="x")

Microscopy images: search_biomedical_images("histology liver", image_type="mc")

Clinical teaching images (MedPix): search_biomedical_images("pneumothorax", collection="mpx")

Case reports with CC-BY license, sorted by date: search_biomedical_images( "lung cancer", article_type="cr", license_type="by", sort_by="d" )

Cardiology specialty images: search_biomedical_images("echocardiogram", specialty="c")

Video content only: search_biomedical_images("surgery technique", video_only=True)

═══════════════════════════════════════════════════════════════

Args: query: Search query (e.g., "chest X-ray pneumonia") image_type: Filter by image type (Open-i only): Positive filters: - "c": CT scan images - "g": Graphics / line art / diagrams - "m": MRI images - "mc": Microscopy / histology images - "p": PET scan images - "ph": Photographs / clinical photos - "u": Ultrasound images - "x": X-ray images Exclusion filters: - "xg": Exclude Graphics (removes graphic images from results) - "xm": Exclude Multipanel (removes multipanel images) - None: All types (default) collection: Filter by collection (Open-i only): - "pmc": PubMed Central articles - "mpx": MedPix clinical teaching images (high quality) - "cxr": Chest X-ray collection - "hmd": History of Medicine - "usc": USC collection - None: All collections (default) limit: Maximum number of images to return (default 10, max 50) sort_by: Sort results by (Open-i only): - "r": Relevance (default) - "d": Date (newest first) - "o": Oldest first - "t": Title - "e": Education relevance - "g": Graphics priority article_type: Filter by article type (Open-i only): - "cr": Case Report - "or": Original Research - "re": Review - "sr": Systematic Review - "ra": Research Article - "ed": Editorial - "lt": Letter - "bk": Book - and more... (see API docs) specialty: Filter by medical specialty (Open-i only): - "r": Radiology - "c": Cardiology - "ne": Neurology - "pu": Pulmonology - "d": Dermatology - "g": Gastroenterology - "or": Orthopedics - "o": Ophthalmology - "s": Surgery - "p": Pediatrics - "id": Infectious Disease - "i": Immunology - and more... (see API docs) license_type: Filter by Creative Commons license (Open-i only): - "by": CC-BY (Attribution) - "bync": CC-BY-NC (Attribution-NonCommercial) - "byncnd": CC-BY-NC-ND (Attribution-NonCommercial-NoDerivs) - "byncsa": CC-BY-NC-SA (Attribution-NonCommercial-ShareAlike) subset: Filter by subject subset (Open-i only): - "b": Behavioral Sciences - "c": Cancer - "e": Ethics - "s": Surgery - "x": Toxicology search_fields: Search in specific fields (Open-i only): - "t": Title only - "m": MeSH terms only - "ab": Abstract only - "msh": MeSH heading only - "c": Caption only - "a": Author only video_only: If True, only return video content (default False) hmp_type: History of Medicine publication type. Requires collection="hmd".

Returns: Formatted image results with URLs, captions, and article metadata

Input Schema

NameRequiredDescriptionDefault
limitNo
queryYes
subsetNo
sort_byNo
hmp_typeNo
specialtyNo
collectionNo
image_typeNo
video_onlyNo
article_typeNo
license_typeNo
search_fieldsNo

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed15 schema fields changedv0.7.7
    • changedInput schema / properties / article_type / anyOf
      Previous value: -[
      -  {
      -    "enum": [
      -      "ab",
      -      "bk",
      -      "bf",
      -      "cr",
      -      "dp",
      -      "di",
      -      "ed",
      -      "ib",
      -      "in",
      -      "lt",
      -      "mr",
      -      "ma",
      -      "ne",
      -      "ob",
      -      "pr",
      -      "or",
      -      "re",
      -      "ra",
      -      "rw",
      -      "sr",
      -      "rr",
      -      "os",
      -      "hs",
      -      "ot"
      -    ],
      -    "type": "string"
      -  },
      -  {
      -    "type": "null"
      -  }
      -]New value: +[
      +  {
      +    "anyOf": [
      +      {
      +        "enum": [
      +          "ab",
      +          "bk",
      +          "bf",
      +          "cr",
      +          "dp",
      +          "di",
      +          "ed",
      +          "ib",
      +          "in",
      +          "lt",
      +          "mr",
      +          "ma",
      +          "ne",
      +          "ob",
      +          "pr",
      +          "or",
      +          "re",
      +          "ra",
      +          "rw",
      +          "sr",
      +          "rr",
      +          "os",
      +          "hs",
      +          "ot"
      +        ],
      +        "type": "string"
      +      },
      +      {
      +        "pattern": "^[ \\t\\r\\n]*(?:[aA][bB]|[bB][kK]|[bB][fF]|[cC][rR]|[dD][pP]|[dD][iI]|[eE][dD]|[iI][bB]|[iI][nN]|[lL][tT]|[mM][rR]|[mM][aA]|[nN][eE]|[oO][bB]|[pP][rR]|[oO][rR]|[rR][eE]|[rR][aA]|[rR][wW]|[sS][rR]|[rR][rR]|[oO][sS]|[hH][sS]|[oO][tT])[ \\t\\r\\n]*$",
      +        "type": "string"
      +      }
      +    ]
      +  },
      +  {
      +    "type": "null"
      +  }
      +]
    • changedInput schema / properties / collection / anyOf
      Previous value: -[
      -  {
      -    "enum": [
      -      "pmc",
      -      "cxr",
      -      "usc",
      -      "hmd",
      -      "mpx"
      -    ],
      -    "type": "string"
      -  },
      -  {
      -    "type": "null"
      -  }
      -]New value: +[
      +  {
      +    "anyOf": [
      +      {
      +        "enum": [
      +          "pmc",
      +          "cxr",
      +          "usc",
      +          "hmd",
      +          "mpx"
      +        ],
      +        "type": "string"
      +      },
      +      {
      +        "pattern": "^[ \\t\\r\\n]*(?:[pP][mM][cC]|[cC][xX][rR]|[uU][sS][cC]|[hH][mM][dD]|[mM][pP][xX])[ \\t\\r\\n]*$",
      +        "type": "string"
      +      }
      +    ]
      +  },
      +  {
      +    "type": "null"
      +  }
      +]
    • changedInput schema / properties / hmp_type / anyOf
      Previous value: -[
      -  {
      -    "enum": [
      -      "ad",
      -      "ar",
      -      "at",
      -      "bi",
      -      "br",
      -      "cr",
      -      "ca",
      -      "ch",
      -      "cg",
      -      "cd",
      -      "dr",
      -      "ep",
      -      "ex",
      -      "hr",
      -      "hu",
      -      "lt",
      -      "mp",
      -      "nw",
      -      "pn",
      -      "ph",
      -      "pi",
      -      "po",
      -      "pt",
      -      "pc",
      -      "ps"
      -    ],
      -    "type": "string"
      -  },
      -  {
      -    "type": "null"
      -  }
      -]New value: +[
      +  {
      +    "anyOf": [
      +      {
      +        "enum": [
      +          "ad",
      +          "ar",
      +          "at",
      +          "bi",
      +          "br",
      +          "cr",
      +          "ca",
      +          "ch",
      +          "cg",
      +          "cd",
      +          "dr",
      +          "ep",
      +          "ex",
      +          "hr",
      +          "hu",
      +          "lt",
      +          "mp",
      +          "nw",
      +          "pn",
      +          "ph",
      +          "pi",
      +          "po",
      +          "pt",
      +          "pc",
      +          "ps"
      +        ],
      +        "type": "string"
      +      },
      +      {
      +        "pattern": "^[ \\t\\r\\n]*(?:[aA][dD]|[aA][rR]|[aA][tT]|[bB][iI]|[bB][rR]|[cC][rR]|[cC][aA]|[cC][hH]|[cC][gG]|[cC][dD]|[dD][rR]|[eE][pP]|[eE][xX]|[hH][rR]|[hH][uU]|[lL][tT]|[mM][pP]|[nN][wW]|[pP][nN]|[pP][hH]|[pP][iI]|[pP][oO]|[pP][tT]|[pP][cC]|[pP][sS])[ \\t\\r\\n]*$",
      +        "type": "string"
      +      }
      +    ]
      +  },
      +  {
      +    "type": "null"
      +  }
      +]
    • changedInput schema / properties / image_type / anyOf
      Previous value: -[
      -  {
      -    "enum": [
      -      "xg",
      -      "xm",
      -      "x",
      -      "u",
      -      "ph",
      -      "p",
      -      "mc",
      -      "m",
      -      "g",
      -      "c"
      -    ],
      -    "type": "string"
      -  },
      -  {
      -    "type": "null"
      -  }
      -]New value: +[
      +  {
      +    "anyOf": [
      +      {
      +        "enum": [
      +          "xg",
      +          "xm",
      +          "x",
      +          "u",
      +          "ph",
      +          "p",
      +          "mc",
      +          "m",
      +          "g",
      +          "c"
      +        ],
      +        "type": "string"
      +      },
      +      {
      +        "pattern": "^[ \\t\\r\\n]*(?:[xX][gG]|[xX][mM]|[xX]|[uU]|[pP][hH]|[pP]|[mM][cC]|[mM]|[gG]|[cC])[ \\t\\r\\n]*$",
      +        "type": "string"
      +      }
      +    ]
      +  },
      +  {
      +    "type": "null"
      +  }
      +]
    • changedInput schema / properties / license_type / anyOf
      Previous value: -[
      -  {
      -    "enum": [
      -      "by",
      -      "bync",
      -      "byncnd",
      -      "byncsa"
      -    ],
      -    "type": "string"
      -  },
      -  {
      -    "type": "null"
      -  }
      -]New value: +[
      +  {
      +    "anyOf": [
      +      {
      +        "enum": [
      +          "by",
      +          "bync",
      +          "byncnd",
      +          "byncsa"
      +        ],
      +        "type": "string"
      +      },
      +      {
      +        "pattern": "^[ \\t\\r\\n]*(?:[bB][yY]|[bB][yY][nN][cC]|[bB][yY][nN][cC][nN][dD]|[bB][yY][nN][cC][sS][aA])[ \\t\\r\\n]*$",
      +        "type": "string"
      +      }
      +    ]
      +  },
      +  {
      +    "type": "null"
      +  }
      +]
    • addedInput schema / properties / limit / anyOf
      Added value: +[
      +  {
      +    "default": 10,
      +    "maximum": 50,
      +    "minimum": 1,
      +    "title": "Limit",
      +    "type": "integer"
      +  },
      +  {
      +    "description": "ASCII decimal integer; the integer branch's bounds apply after conversion.",
      +    "maxLength": 32,
      +    "pattern": "^[ \\t\\r\\n]*-?(?:0|[1-9][0-9]*)[ \\t\\r\\n]*$",
      +    "type": "string"
      +  }
      +]
    • removedInput schema / properties / limit / maximum
      Removed value: -50
    • removedInput schema / properties / limit / minimum
      Removed value: -1
    • removedInput schema / properties / limit / type
      Removed value: -"integer"
    • changedInput schema / properties / search_fields / anyOf
      Previous value: -[
      -  {
      -    "enum": [
      -      "t",
      -      "m",
      -      "ab",
      -      "msh",
      -      "c",
      -      "a"
      -    ],
      -    "type": "string"
      -  },
      -  {
      -    "type": "null"
      -  }
      -]New value: +[
      +  {
      +    "anyOf": [
      +      {
      +        "enum": [
      +          "t",
      +          "m",
      +          "ab",
      +          "msh",
      +          "c",
      +          "a"
      +        ],
      +        "type": "string"
      +      },
      +      {
      +        "pattern": "^[ \\t\\r\\n]*(?:[tT]|[mM]|[aA][bB]|[mM][sS][hH]|[cC]|[aA])[ \\t\\r\\n]*$",
      +        "type": "string"
      +      }
      +    ]
      +  },
      +  {
      +    "type": "null"
      +  }
      +]
    • changedInput schema / properties / sort_by / anyOf
      Previous value: -[
      -  {
      -    "enum": [
      -      "r",
      -      "o",
      -      "d",
      -      "e",
      -      "g",
      -      "oc",
      -      "pr",
      -      "pg",
      -      "t"
      -    ],
      -    "type": "string"
      -  },
      -  {
      -    "type": "null"
      -  }
      -]New value: +[
      +  {
      +    "anyOf": [
      +      {
      +        "enum": [
      +          "r",
      +          "o",
      +          "d",
      +          "e",
      +          "g",
      +          "oc",
      +          "pr",
      +          "pg",
      +          "t"
      +        ],
      +        "type": "string"
      +      },
      +      {
      +        "pattern": "^[ \\t\\r\\n]*(?:[rR]|[oO]|[dD]|[eE]|[gG]|[oO][cC]|[pP][rR]|[pP][gG]|[tT])[ \\t\\r\\n]*$",
      +        "type": "string"
      +      }
      +    ]
      +  },
      +  {
      +    "type": "null"
      +  }
      +]
    • changedInput schema / properties / specialty / anyOf
      Previous value: -[
      -  {
      -    "enum": [
      -      "b",
      -      "bc",
      -      "c",
      -      "ca",
      -      "cc",
      -      "d",
      -      "de",
      -      "dt",
      -      "e",
      -      "en",
      -      "f",
      -      "eh",
      -      "g",
      -      "ge",
      -      "gr",
      -      "gy",
      -      "h",
      -      "i",
      -      "id",
      -      "im",
      -      "n",
      -      "ne",
      -      "nu",
      -      "o",
      -      "or",
      -      "ot",
      -      "p",
      -      "py",
      -      "pu",
      -      "r",
      -      "s",
      -      "t",
      -      "u",
      -      "v",
      -      "vi"
      -    ],
      -    "type": "string"
      -  },
      -  {
      -    "type": "null"
      -  }
      -]New value: +[
      +  {
      +    "anyOf": [
      +      {
      +        "enum": [
      +          "b",
      +          "bc",
      +          "c",
      +          "ca",
      +          "cc",
      +          "d",
      +          "de",
      +          "dt",
      +          "e",
      +          "en",
      +          "f",
      +          "eh",
      +          "g",
      +          "ge",
      +          "gr",
      +          "gy",
      +          "h",
      +          "i",
      +          "id",
      +          "im",
      +          "n",
      +          "ne",
      +          "nu",
      +          "o",
      +          "or",
      +          "ot",
      +          "p",
      +          "py",
      +          "pu",
      +          "r",
      +          "s",
      +          "t",
      +          "u",
      +          "v",
      +          "vi"
      +        ],
      +        "type": "string"
      +      },
      +      {
      +        "pattern": "^[ \\t\\r\\n]*(?:[bB]|[bB][cC]|[cC]|[cC][aA]|[cC][cC]|[dD]|[dD][eE]|[dD][tT]|[eE]|[eE][nN]|[fF]|[eE][hH]|[gG]|[gG][eE]|[gG][rR]|[gG][yY]|[hH]|[iI]|[iI][dD]|[iI][mM]|[nN]|[nN][eE]|[nN][uU]|[oO]|[oO][rR]|[oO][tT]|[pP]|[pP][yY]|[pP][uU]|[rR]|[sS]|[tT]|[uU]|[vV]|[vV][iI])[ \\t\\r\\n]*$",
      +        "type": "string"
      +      }
      +    ]
      +  },
      +  {
      +    "type": "null"
      +  }
      +]
    • changedInput schema / properties / subset / anyOf
      Previous value: -[
      -  {
      -    "enum": [
      -      "b",
      -      "c",
      -      "e",
      -      "s",
      -      "x"
      -    ],
      -    "type": "string"
      -  },
      -  {
      -    "type": "null"
      -  }
      -]New value: +[
      +  {
      +    "anyOf": [
      +      {
      +        "enum": [
      +          "b",
      +          "c",
      +          "e",
      +          "s",
      +          "x"
      +        ],
      +        "type": "string"
      +      },
      +      {
      +        "pattern": "^[ \\t\\r\\n]*(?:[bB]|[cC]|[eE]|[sS]|[xX])[ \\t\\r\\n]*$",
      +        "type": "string"
      +      }
      +    ]
      +  },
      +  {
      +    "type": "null"
      +  }
      +]
    • addedInput schema / properties / video_only / anyOf
      Added value: +[
      +  {
      +    "default": false,
      +    "title": "Video Only",
      +    "type": "boolean"
      +  },
      +  {
      +    "description": "Explicit true/false text, ignoring ASCII case and surrounding whitespace.",
      +    "pattern": "^[ \\t\\r\\n]*(?:[tT][rR][uU][eE]|[fF][aA][lL][sS][eE])[ \\t\\r\\n]*$",
      +    "type": "string"
      +  }
      +]
    • removedInput schema / properties / video_only / type
      Removed value: -"boolean"
  2. Changed21 schema fields changedv0.7.2
    • addedInput schema / additionalProperties
      Added value: +false
    • changedInput schema / properties / article_type / anyOf
      Previous value: -[
      -  {
      -    "type": "string"
      -  },
      -  {
      -    "type": "null"
      -  }
      -]New value: +[
      +  {
      +    "enum": [
      +      "ab",
      +      "bk",
      +      "bf",
      +      "cr",
      +      "dp",
      +      "di",
      +      "ed",
      +      "ib",
      +      "in",
      +      "lt",
      +      "mr",
      +      "ma",
      +      "ne",
      +      "ob",
      +      "pr",
      +      "or",
      +      "re",
      +      "ra",
      +      "rw",
      +      "sr",
      +      "rr",
      +      "os",
      +      "hs",
      +      "ot"
      +    ],
      +    "type": "string"
      +  },
      +  {
      +    "type": "null"
      +  }
      +]
    • changedInput schema / properties / collection / anyOf
      Previous value: -[
      -  {
      -    "type": "string"
      -  },
      -  {
      -    "type": "null"
      -  }
      -]New value: +[
      +  {
      +    "enum": [
      +      "pmc",
      +      "cxr",
      +      "usc",
      +      "hmd",
      +      "mpx"
      +    ],
      +    "type": "string"
      +  },
      +  {
      +    "type": "null"
      +  }
      +]
    • addedInput schema / properties / hmp_type
      Added value: +{
      +  "anyOf": [
      +    {
      +      "enum": [
      +        "ad",
      +        "ar",
      +        "at",
      +        "bi",
      +        "br",
      +        "cr",
      +        "ca",
      +        "ch",
      +        "cg",
      +        "cd",
      +        "dr",
      +        "ep",
      +        "ex",
      +        "hr",
      +        "hu",
      +        "lt",
      +        "mp",
      +        "nw",
      +        "pn",
      +        "ph",
      +        "pi",
      +        "po",
      +        "pt",
      +        "pc",
      +        "ps"
      +      ],
      +      "type": "string"
      +    },
      +    {
      +      "type": "null"
      +    }
      +  ],
      +  "default": null,
      +  "title": "Hmp Type"
      +}
    • changedInput schema / properties / image_type / anyOf
      Previous value: -[
      -  {
      -    "type": "string"
      -  },
      -  {
      -    "type": "null"
      -  }
      -]New value: +[
      +  {
      +    "enum": [
      +      "xg",
      +      "xm",
      +      "x",
      +      "u",
      +      "ph",
      +      "p",
      +      "mc",
      +      "m",
      +      "g",
      +      "c"
      +    ],
      +    "type": "string"
      +  },
      +  {
      +    "type": "null"
      +  }
      +]
    • changedInput schema / properties / license_type / anyOf
      Previous value: -[
      -  {
      -    "type": "string"
      -  },
      -  {
      -    "type": "null"
      -  }
      -]New value: +[
      +  {
      +    "enum": [
      +      "by",
      +      "bync",
      +      "byncnd",
      +      "byncsa"
      +    ],
      +    "type": "string"
      +  },
      +  {
      +    "type": "null"
      +  }
      +]
    • removedInput schema / properties / limit / anyOf
      Removed value: -[
      -  {
      -    "type": "integer"
      -  },
      -  {
      -    "type": "string"
      -  }
      -]
    • addedInput schema / properties / limit / maximum
      Added value: +50
    • addedInput schema / properties / limit / minimum
      Added value: +1
    • addedInput schema / properties / limit / type
      Added value: +"integer"
    • removedInput schema / properties / open_access_only
      Removed value: -{
      -  "anyOf": [
      -    {
      -      "type": "boolean"
      -    },
      -    {
      -      "type": "string"
      -    }
      -  ],
      -  "default": true,
      -  "title": "Open Access Only"
      -}
    • addedInput schema / properties / query / maxLength
      Added value: +500
    • addedInput schema / properties / query / minLength
      Added value: +1
    • changedInput schema / properties / search_fields / anyOf
      Previous value: -[
      -  {
      -    "type": "string"
      -  },
      -  {
      -    "type": "null"
      -  }
      -]New value: +[
      +  {
      +    "enum": [
      +      "t",
      +      "m",
      +      "ab",
      +      "msh",
      +      "c",
      +      "a"
      +    ],
      +    "type": "string"
      +  },
      +  {
      +    "type": "null"
      +  }
      +]
    • changedInput schema / properties / sort_by / anyOf
      Previous value: -[
      -  {
      -    "type": "string"
      -  },
      -  {
      -    "type": "null"
      -  }
      -]New value: +[
      +  {
      +    "enum": [
      +      "r",
      +      "o",
      +      "d",
      +      "e",
      +      "g",
      +      "oc",
      +      "pr",
      +      "pg",
      +      "t"
      +    ],
      +    "type": "string"
      +  },
      +  {
      +    "type": "null"
      +  }
      +]
    • removedInput schema / properties / sources
      Removed value: -{
      -  "default": "auto",
      -  "title": "Sources",
      -  "type": "string"
      -}
    • changedInput schema / properties / specialty / anyOf
      Previous value: -[
      -  {
      -    "type": "string"
      -  },
      -  {
      -    "type": "null"
      -  }
      -]New value: +[
      +  {
      +    "enum": [
      +      "b",
      +      "bc",
      +      "c",
      +      "ca",
      +      "cc",
      +      "d",
      +      "de",
      +      "dt",
      +      "e",
      +      "en",
      +      "f",
      +      "eh",
      +      "g",
      +      "ge",
      +      "gr",
      +      "gy",
      +      "h",
      +      "i",
      +      "id",
      +      "im",
      +      "n",
      +      "ne",
      +      "nu",
      +      "o",
      +      "or",
      +      "ot",
      +      "p",
      +      "py",
      +      "pu",
      +      "r",
      +      "s",
      +      "t",
      +      "u",
      +      "v",
      +      "vi"
      +    ],
      +    "type": "string"
      +  },
      +  {
      +    "type": "null"
      +  }
      +]
    • changedInput schema / properties / subset / anyOf
      Previous value: -[
      -  {
      -    "type": "string"
      -  },
      -  {
      -    "type": "null"
      -  }
      -]New value: +[
      +  {
      +    "enum": [
      +      "b",
      +      "c",
      +      "e",
      +      "s",
      +      "x"
      +    ],
      +    "type": "string"
      +  },
      +  {
      +    "type": "null"
      +  }
      +]
    • removedInput schema / properties / video_only / anyOf
      Removed value: -[
      -  {
      -    "type": "boolean"
      -  },
      -  {
      -    "type": "string"
      -  }
      -]
    • addedInput schema / properties / video_only / type
      Added value: +"boolean"
    • changedOutput schema / (root)
      Previous value: -{
      -  "properties": {
      -    "result": {
      -      "title": "Result",
      -      "type": "string"
      -    }
      -  },
      -  "required": [
      -    "result"
      -  ],
      -  "title": "search_biomedical_imagesOutput",
      -  "type": "object"
      -}New value: +null
  3. First observedv0.5.16

TDQS

A4.3/5.0
Behavior4/5

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

Annotations already declare readOnly/idempotent/openWorld, and the description adds genuine operational context on top: Open-i accepts English only, built-in CJK translation hints exist but must be verified, limit defaults to 10 with a max of 50, and hmp_type requires collection='hmd'. It does not cover rate limits or result pagination, which keeps it short of a 5.

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

Conciseness3/5

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

Purpose and the critical language rule are front-loaded, which is good, but the repeated full-width ASCII rule lines and emoji consume substantial tokens without adding information, and the source list restates the opening sentence. The enum documentation earns its space; the decorative separators do not.

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

Completeness4/5

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

For a 12-parameter tool with no schema descriptions and no output schema, the description supplies nearly everything needed to call it correctly, including filter semantics and the return shape in prose. Gaps remain around pagination and behavior when zero images match.

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

Parameters5/5

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

Schema description coverage is 0%, so the description carries the full burden, and it does: every parameter's enum codes are decoded (image_type, collection, sort_by, specialty, license_type, subset, search_fields), inclusion vs exclusion filters are separated, and the cross-parameter dependency on collection='hmd' is stated. Only a few enum members are deferred to "see API docs".

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

Purpose5/5

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

The first line names the exact verb, resource, and source ("Search biomedical images from NLM Open-i") and the second states the return content (image URLs with caption, article info, MeSH terms). It is unambiguously distinguishable from article-oriented siblings like unified_search and fetch_article_details.

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

Usage Guidelines4/5

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

Provides rich context for use: the mandatory English-query rule, a translation workflow, and seven worked examples mapping intent to filters (collection='mpx' for MedPix, video_only for video). However, it never routes the agent away from or toward the closest siblings such as get_article_figures or prepare_figure_search, so the when-not half is missing.

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