Skip to main content
Glama

Check a tool

forge_check
Read-onlyIdempotent

Use this when a task is about to rely on one skill, MCP server, plugin, package or API and the question is whether agents had problems with it or an advisory covers it. Give one of id (npm:name, pypi:name, github.com/owner/repo), url or fingerprint (sha256:<64 hex>), plus version if known. Returns field reports (agents' notes on that version), OSV advisories, security status and a page link. File text: forge_scan.

Input Schema

NameRequiredDescriptionDefault
idNoTool id, e.g. npm:@scope/name, pypi:name or github.com/owner/repo/path; a version may be inline (npm:name@1.2.3, pypi:name==1.2.3)
urlNoA web URL for the tool, e.g. its GitHub or npm page
detailNocompact (default): summary first, top advisories, capped lists; full: every advisory and field
versionNoThe exact version in use, e.g. 1.4.2, to match published advisories
fingerprintNosha256:<64 hex> of the exact version

Output Schema

NameRequiredDescriptionDefault

No arguments

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed1 schema field changed
    • changedOutput schema / anyOf
      Previous value: -[
      -  {
      -    "additionalProperties": {},
      -    "properties": {
      -      "asked_version": {
      -        "type": "string"
      -      },
      -      "be_first": {
      -        "type": "boolean"
      -      },
      -      "candidates": {
      -        "items": {
      -          "additionalProperties": {},
      -          "properties": {
      -            "id": {
      -              "type": "string"
      -            },
      -            "page_url": {
      -              "type": "string"
      -            }
      -          },
      -          "required": [
      -            "id",
      -            "page_url"
      -          ],
      -          "type": "object"
      -        },
      -        "type": "array"
      -      },
      -      "contribute": {
      -        "additionalProperties": {},
      -        "properties": {
      -          "auth": {
      -            "const": "github_oauth",
      -            "type": "string"
      -          },
      -          "human_verified": {
      -            "const": true,
      -            "type": "boolean"
      -          },
      -          "mcp_server": {
      -            "type": "string"
      -          },
      -          "report_url": {
      -            "type": [
      -              "string",
      -              "null"
      -            ]
      -          },
      -          "tool": {
      -            "const": "forge_report",
      -            "type": "string"
      -          }
      -        },
      -        "required": [
      -          "tool",
      -          "mcp_server",
      -          "auth",
      -          "human_verified"
      -        ],
      -        "type": "object"
      -      },
      -      "corroborated_reports": {
      -        "type": "number"
      -      },
      -      "distinct_owners": {
      -        "type": "number"
      -      },
      -      "fingerprint": {
      -        "type": [
      -          "string",
      -          "null"
      -        ]
      -      },
      -      "forge_score": {
      -        "type": [
      -          "number",
      -          "null"
      -        ]
      -      },
      -      "known": {
      -        "type": "boolean"
      -      },
      -      "loop_rate": {
      -        "type": [
      -          "number",
      -          "null"
      -        ]
      -      },
      -      "other_versions_flagged": {
      -        "items": {
      -          "additionalProperties": {},
      -          "properties": {
      -            "security_status": {
      -              "enum": [
      -                "clear",
      -                "caution",
      -                "flagged",
      -                "confirmed_malicious",
      -                "unknown"
      -              ],
      -              "type": "string"
      -            },
      -            "version": {
      -              "type": "string"
      -            }
      -          },
      -          "required": [
      -            "version",
      -            "security_status"
      -          ],
      -          "type": "object"
      -        },
      -        "type": "array"
      -      },
      -      "outcome_breakdown": {
      -        "additionalProperties": {},
      -        "properties": {
      -          "failed": {
      -            "type": "number"
      -          },
      -          "partial": {
      -            "type": "number"
      -          },
      -          "worked": {
      -            "type": "number"
      -          }
      -        },
      -        "required": [
      -          "worked",
      -          "partial",
      -          "failed"
      -        ],
      -        "type": "object"
      -      },
      -      "page_url": {
      -        "type": [
      -          "string",
      -          "null"
      -        ]
      -      },
      -      "public_signals_summary": {
      -        "anyOf": [
      -          {
      -            "additionalProperties": {},
      -            "properties": {
      -              "advisories": {
      -                "items": {
      -                  "additionalProperties": {},
      -                  "properties": {
      -                    "affects_version": {
      -                      "type": [
      -                        "boolean",
      -                        "null"
      -                      ]
      -                    },
      -                    "aliases": {
      -                      "items": {
      -                        "type": "string"
      -                      },
      -                      "type": "array"
      -                    },
      -                    "exploited_in_wild": {
      -                      "type": "boolean"
      -                    },
      -                    "fixed": {
      -                      "items": {
      -                        "type": "string"
      -                      },
      -                      "type": "array"
      -                    },
      -                    "id": {
      -                      "type": "string"
      -                    },
      -                    "kind": {
      -                      "enum": [
      -                        "malicious",
      -                        "vulnerability"
      -                      ],
      -                      "type": "string"
      -                    },
      -                    "modified": {
      -                      "type": [
      -                        "string",
      -                        "null"
      -                      ]
      -                    },
      -                    "published": {
      -                      "type": [
      -                        "string",
      -                        "null"
      -                      ]
      -                    },
      -                    "url": {
      -                      "type": "string"
      -                    }
      -                  },
      -                  "required": [
      -                    "id",
      -                    "kind",
      -                    "aliases",
      -                    "fixed",
      -                    "url"
      -                  ],
      -                  "type": "object"
      -                },
      -                "type": "array"
      -              },
      -              "checked_at": {
      -                "type": "string"
      -              },
      -              "ecosystem": {
      -                "type": "string"
      -              },
      -              "full_list_url": {
      -                "type": "string"
      -              },
      -              "kev_as_of": {
      -                "type": [
      -                  "string",
      -                  "null"
      -                ]
      -              },
      -              "package": {
      -                "type": "string"
      -              },
      -              "shown": {
      -                "type": "number"
      -              },
      -              "source": {
      -                "const": "osv",
      -                "type": "string"
      -              },
      -              "total": {
      -                "type": "number"
      -              },
      -              "truncated": {
      -                "const": true,
      -                "type": "boolean"
      -              },
      -              "version": {
      -                "type": [
      -                  "string",
      -                  "null"
      -                ]
      -              }
      -            },
      -            "required": [
      -              "source",
      -              "ecosystem",
      -              "package",
      -              "version",
      -              "checked_at",
      -              "total",
      -              "advisories"
      -            ],
      -            "type": "object"
      -          },
      -          {
      -            "type": "null"
      -          }
      -        ]
      -      },
      -      "recovers_after_reset_rate": {
      -        "type": [
      -          "number",
      -          "null"
      -        ]
      -      },
      -      "related": {
      -        "items": {
      -          "additionalProperties": {},
      -          "properties": {
      -            "arguments": {
      -              "additionalProperties": {},
      -              "propertyNames": {
      -                "type": "string"
      -              },
      -              "type": "object"
      -            },
      -            "mcp_server": {
      -              "type": "string"
      -            },
      -            "relation": {
      -              "enum": [
      -                "full_answer",
      -                "scan_skill_file",
      -                "candidate",
      -                "watch_fingerprint",
      -                "check_match",
      -                "rescan"
      -              ],
      -              "type": "string"
      -            },
      -            "tool": {
      -              "enum": [
      -                "forge_check",
      -                "forge_scan",
      -                "forge_watch"
      -              ],
      -              "type": "string"
      -            }
      -          },
      -          "required": [
      -            "relation",
      -            "tool",
      -            "arguments"
      -          ],
      -          "type": "object"
      -        },
      -        "type": "array"
      -      },
      -      "reports": {
      -        "items": {
      -          "additionalProperties": {},
      -          "properties": {
      -            "created_at": {
      -              "type": "string"
      -            },
      -            "outcome": {
      -              "enum": [
      -                "worked",
      -                "partial",
      -                "failed"
      -              ],
      -              "type": "string"
      -            },
      -            "report_id": {
      -              "type": "string"
      -            }
      -          },
      -          "required": [
      -            "report_id",
      -            "outcome",
      -            "created_at"
      -          ],
      -          "type": "object"
      -        },
      -        "type": "array"
      -      },
      -      "reports_for_this_version": {
      -        "type": "number"
      -      },
      -      "reports_shown": {
      -        "type": "number"
      -      },
      -      "reports_truncated": {
      -        "const": true,
      -        "type": "boolean"
      -      },
      -      "security_status": {
      -        "enum": [
      -          "clear",
      -          "caution",
      -          "flagged",
      -          "confirmed_malicious",
      -          "unknown"
      -        ],
      -        "type": "string"
      -      },
      -      "share": {
      -        "additionalProperties": {},
      -        "properties": {
      -          "badge_markdown": {
      -            "type": [
      -              "string",
      -              "null"
      -            ]
      -          },
      -          "page_url": {
      -            "type": [
      -              "string",
      -              "null"
      -            ]
      -          },
      -          "receipt_badge_url": {
      -            "type": "string"
      -          },
      -          "receipt_markdown": {
      -            "type": "string"
      -          },
      -          "receipt_url": {
      -            "type": "string"
      -          }
      -        },
      -        "required": [
      -          "receipt_url"
      -        ],
      -        "type": "object"
      -      },
      -      "strain_hook_reports": {
      -        "type": "number"
      -      },
      -      "strain_reports": {
      -        "type": "number"
      -      },
      -      "summary": {
      -        "additionalProperties": {},
      -        "properties": {
      -          "advisories": {
      -            "type": "number"
      -          },
      -          "advisories_checked": {
      -            "type": "boolean"
      -          },
      -          "candidates": {
      -            "type": "number"
      -          },
      -          "exploited_in_wild": {
      -            "type": "number"
      -          },
      -          "field_reports": {
      -            "type": "number"
      -          },
      -          "forge_score": {
      -            "type": "number"
      -          },
      -          "known": {
      -            "type": "boolean"
      -          },
      -          "malicious": {
      -            "type": "number"
      -          },
      -          "other_versions_flagged": {
      -            "type": "number"
      -          },
      -          "people": {
      -            "type": "number"
      -          },
      -          "security_status": {
      -            "enum": [
      -              "clear",
      -              "caution",
      -              "flagged",
      -              "confirmed_malicious",
      -              "unknown"
      -            ],
      -            "type": "string"
      -          },
      -          "tool": {
      -            "type": "string"
      -          },
      -          "top_advisories": {
      -            "items": {
      -              "additionalProperties": {},
      -              "properties": {
      -                "cve": {
      -                  "type": "string"
      -                },
      -                "exploited_in_wild": {
      -                  "const": true,
      -                  "type": "boolean"
      -                },
      -                "fixed_in": {
      -                  "items": {
      -                    "type": "string"
      -                  },
      -                  "type": "array"
      -                },
      -                "id": {
      -                  "type": "string"
      -                },
      -                "kind": {
      -                  "enum": [
      -                    "malicious",
      -                    "vulnerability"
      -                  ],
      -                  "type": "string"
      -                }
      -              },
      -              "required": [
      -                "id",
      -                "kind"
      -              ],
      -              "type": "object"
      -            },
      -            "type": "array"
      -          },
      -          "verdict": {
      -            "enum": [
      -              "clear",
      -              "caution",
      -              "flagged",
      -              "confirmed_malicious",
      -              "insufficient"
      -            ],
      -            "type": "string"
      -          },
      -          "verified_people": {
      -            "type": "number"
      -          },
      -          "version": {
      -            "type": "string"
      -          }
      -        },
      -        "required": [
      -          "verdict",
      -          "security_status",
      -          "known",
      -          "tool",
      -          "field_reports",
      -          "people",
      -          "verified_people",
      -          "advisories_checked"
      -        ],
      -        "type": "object"
      -      },
      -      "tool": {
      -        "anyOf": [
      -          {
      -            "additionalProperties": {},
      -            "properties": {
      -              "id": {
      -                "type": "string"
      -              },
      -              "kind": {
      -                "type": "string"
      -              }
      -            },
      -            "required": [
      -              "kind",
      -              "id"
      -            ],
      -            "type": "object"
      -          },
      -          {
      -            "type": "null"
      -          }
      -        ]
      -      },
      -      "verdict": {
      -        "enum": [
      -          "clear",
      -          "caution",
      -          "flagged",
      -          "confirmed_malicious",
      -          "insufficient"
      -        ],
      -        "type": "string"
      -      },
      -      "verified_owners": {
      -        "type": "number"
      -      },
      -      "version": {
      -        "type": [
      -          "string",
      -          "null"
      -        ]
      -      }
      -    },
      -    "required": [
      -      "summary",
      -      "known",
      -      "distinct_owners",
      -      "verified_owners",
      -      "outcome_breakdown",
      -      "security_status",
      -      "verdict",
      -      "reports_for_this_version",
      -      "be_first",
      -      "contribute",
      -      "corroborated_reports",
      -      "share"
      -    ],
      -    "type": "object"
      -  },
      -  {
      -    "additionalProperties": {},
      -    "properties": {
      -      "data_kind": {
      -        "const": "input_needed",
      -        "type": "string"
      -      },
      -      "detail": {
      -        "type": [
      -          "string",
      -          "null"
      -        ]
      -      },
      -      "error": {
      -        "type": "string"
      -      },
      -      "examples": {
      -        "items": {
      -          "additionalProperties": {},
      -          "propertyNames": {
      -            "type": "string"
      -          },
      -          "type": "object"
      -        },
      -        "type": "array"
      -      },
      -      "needed": {
      -        "type": "string"
      -      },
      -      "tool": {
      -        "type": "string"
      -      }
      -    },
      -    "required": [
      -      "error",
      -      "data_kind",
      -      "tool",
      -      "needed",
      -      "detail",
      -      "examples"
      -    ],
      -    "type": "object"
      -  },
      -  {
      -    "additionalProperties": {},
      -    "properties": {
      -      "error": {
      -        "const": "rate_limited",
      -        "type": "string"
      -      },
      -      "limit": {
      -        "additionalProperties": {},
      -        "properties": {
      -          "per_minute": {
      -            "type": [
      -              "number",
      -              "null"
      -            ]
      -          },
      -          "per_month": {
      -            "type": [
      -              "number",
      -              "null"
      -            ]
      -          },
      -          "plan": {
      -            "enum": [
      -              "anonymous",
      -              "free",
      -              "team",
      -              "volume",
      -              "enterprise"
      -            ],
      -            "type": "string"
      -          },
      -          "resets_at": {
      -            "type": "string"
      -          },
      -          "used_this_month": {
      -            "type": "number"
      -          }
      -        },
      -        "required": [
      -          "plan",
      -          "per_minute"
      -        ],
      -        "type": "object"
      -      },
      -      "reason": {
      -        "enum": [
      -          "per_ip_minute",
      -          "per_key_minute",
      -          "monthly_quota"
      -        ],
      -        "type": "string"
      -      },
      -      "retry_after_s": {
      -        "type": "number"
      -      },
      -      "upgrade": {
      -        "additionalProperties": {},
      -        "properties": {
      -          "contact": {
      -            "type": "string"
      -          },
      -          "free_key": {
      -            "additionalProperties": {},
      -            "properties": {
      -              "per_minute": {
      -                "type": [
      -                  "number",
      -                  "null"
      -                ]
      -              },
      -              "per_month": {
      -                "type": [
      -                  "number",
      -                  "null"
      -                ]
      -              }
      -            },
      -            "required": [
      -              "per_minute",
      -              "per_month"
      -            ],
      -            "type": "object"
      -          },
      -          "keys_url": {
      -            "type": "string"
      -          },
      -          "paid_plans": {
      -            "enum": [
      -              "coming_soon",
      -              "available"
      -            ],
      -            "type": "string"
      -          },
      -          "plans": {
      -            "items": {
      -              "enum": [
      -                "team",
      -                "volume"
      -              ],
      -              "type": "string"
      -            },
      -            "type": "array"
      -          },
      -          "url": {
      -            "type": "string"
      -          }
      -        },
      -        "required": [
      -          "url",
      -          "keys_url",
      -          "plans",
      -          "paid_plans"
      -        ],
      -        "type": "object"
      -      }
      -    },
      -    "required": [
      -      "error",
      -      "retry_after_s"
      -    ],
      -    "type": "object"
      -  }
      -]New value: +[
      +  {
      +    "additionalProperties": {},
      +    "properties": {
      +      "asked_version": {
      +        "type": "string"
      +      },
      +      "be_first": {
      +        "type": "boolean"
      +      },
      +      "candidates": {
      +        "items": {
      +          "additionalProperties": {},
      +          "properties": {
      +            "id": {
      +              "type": "string"
      +            },
      +            "page_url": {
      +              "type": "string"
      +            }
      +          },
      +          "required": [
      +            "id",
      +            "page_url"
      +          ],
      +          "type": "object"
      +        },
      +        "type": "array"
      +      },
      +      "contribute": {
      +        "additionalProperties": {},
      +        "properties": {
      +          "auth": {
      +            "const": "github_oauth",
      +            "type": "string"
      +          },
      +          "human_verified": {
      +            "const": true,
      +            "type": "boolean"
      +          },
      +          "mcp_server": {
      +            "type": "string"
      +          },
      +          "report_url": {
      +            "type": [
      +              "string",
      +              "null"
      +            ]
      +          },
      +          "tool": {
      +            "const": "forge_report",
      +            "type": "string"
      +          }
      +        },
      +        "required": [
      +          "tool",
      +          "mcp_server",
      +          "auth",
      +          "human_verified"
      +        ],
      +        "type": "object"
      +      },
      +      "corroborated_reports": {
      +        "type": "number"
      +      },
      +      "distinct_owners": {
      +        "type": "number"
      +      },
      +      "fingerprint": {
      +        "type": [
      +          "string",
      +          "null"
      +        ]
      +      },
      +      "forge_score": {
      +        "type": [
      +          "number",
      +          "null"
      +        ]
      +      },
      +      "known": {
      +        "type": "boolean"
      +      },
      +      "loop_rate": {
      +        "type": [
      +          "number",
      +          "null"
      +        ]
      +      },
      +      "other_versions_flagged": {
      +        "items": {
      +          "additionalProperties": {},
      +          "properties": {
      +            "security_status": {
      +              "enum": [
      +                "clear",
      +                "caution",
      +                "flagged",
      +                "confirmed_malicious",
      +                "unknown"
      +              ],
      +              "type": "string"
      +            },
      +            "version": {
      +              "type": "string"
      +            }
      +          },
      +          "required": [
      +            "version",
      +            "security_status"
      +          ],
      +          "type": "object"
      +        },
      +        "type": "array"
      +      },
      +      "outcome_breakdown": {
      +        "additionalProperties": {},
      +        "properties": {
      +          "failed": {
      +            "type": "number"
      +          },
      +          "partial": {
      +            "type": "number"
      +          },
      +          "worked": {
      +            "type": "number"
      +          }
      +        },
      +        "required": [
      +          "worked",
      +          "partial",
      +          "failed"
      +        ],
      +        "type": "object"
      +      },
      +      "owner_claim": {
      +        "additionalProperties": {},
      +        "properties": {
      +          "enables": {
      +            "items": {
      +              "type": "string"
      +            },
      +            "type": "array"
      +          },
      +          "url": {
      +            "type": "string"
      +          },
      +          "what": {
      +            "type": "string"
      +          }
      +        },
      +        "required": [
      +          "url",
      +          "what",
      +          "enables"
      +        ],
      +        "type": "object"
      +      },
      +      "page_url": {
      +        "type": [
      +          "string",
      +          "null"
      +        ]
      +      },
      +      "public_signals_summary": {
      +        "anyOf": [
      +          {
      +            "additionalProperties": {},
      +            "properties": {
      +              "advisories": {
      +                "items": {
      +                  "additionalProperties": {},
      +                  "properties": {
      +                    "affects_version": {
      +                      "type": [
      +                        "boolean",
      +                        "null"
      +                      ]
      +                    },
      +                    "aliases": {
      +                      "items": {
      +                        "type": "string"
      +                      },
      +                      "type": "array"
      +                    },
      +                    "exploited_in_wild": {
      +                      "type": "boolean"
      +                    },
      +                    "fixed": {
      +                      "items": {
      +                        "type": "string"
      +                      },
      +                      "type": "array"
      +                    },
      +                    "id": {
      +                      "type": "string"
      +                    },
      +                    "kind": {
      +                      "enum": [
      +                        "malicious",
      +                        "vulnerability"
      +                      ],
      +                      "type": "string"
      +                    },
      +                    "modified": {
      +                      "type": [
      +                        "string",
      +                        "null"
      +                      ]
      +                    },
      +                    "published": {
      +                      "type": [
      +                        "string",
      +                        "null"
      +                      ]
      +                    },
      +                    "url": {
      +                      "type": "string"
      +                    }
      +                  },
      +                  "required": [
      +                    "id",
      +                    "kind",
      +                    "aliases",
      +                    "fixed",
      +                    "url"
      +                  ],
      +                  "type": "object"
      +                },
      +                "type": "array"
      +              },
      +              "checked_at": {
      +                "type": "string"
      +              },
      +              "ecosystem": {
      +                "type": "string"
      +              },
      +              "full_list_url": {
      +                "type": "string"
      +              },
      +              "kev_as_of": {
      +                "type": [
      +                  "string",
      +                  "null"
      +                ]
      +              },
      +              "package": {
      +                "type": "string"
      +              },
      +              "shown": {
      +                "type": "number"
      +              },
      +              "source": {
      +                "const": "osv",
      +                "type": "string"
      +              },
      +              "total": {
      +                "type": "number"
      +              },
      +              "truncated": {
      +                "const": true,
      +                "type": "boolean"
      +              },
      +              "version": {
      +                "type": [
      +                  "string",
      +                  "null"
      +                ]
      +              }
      +            },
      +            "required": [
      +              "source",
      +              "ecosystem",
      +              "package",
      +              "version",
      +              "checked_at",
      +              "total",
      +              "advisories"
      +            ],
      +            "type": "object"
      +          },
      +          {
      +            "type": "null"
      +          }
      +        ]
      +      },
      +      "recovers_after_reset_rate": {
      +        "type": [
      +          "number",
      +          "null"
      +        ]
      +      },
      +      "related": {
      +        "items": {
      +          "additionalProperties": {},
      +          "properties": {
      +            "arguments": {
      +              "additionalProperties": {},
      +              "propertyNames": {
      +                "type": "string"
      +              },
      +              "type": "object"
      +            },
      +            "mcp_server": {
      +              "type": "string"
      +            },
      +            "relation": {
      +              "enum": [
      +                "full_answer",
      +                "scan_skill_file",
      +                "candidate",
      +                "watch_fingerprint",
      +                "check_match",
      +                "rescan"
      +              ],
      +              "type": "string"
      +            },
      +            "tool": {
      +              "enum": [
      +                "forge_check",
      +                "forge_scan",
      +                "forge_watch"
      +              ],
      +              "type": "string"
      +            }
      +          },
      +          "required": [
      +            "relation",
      +            "tool",
      +            "arguments"
      +          ],
      +          "type": "object"
      +        },
      +        "type": "array"
      +      },
      +      "reports": {
      +        "items": {
      +          "additionalProperties": {},
      +          "properties": {
      +            "created_at": {
      +              "type": "string"
      +            },
      +            "outcome": {
      +              "enum": [
      +                "worked",
      +                "partial",
      +                "failed"
      +              ],
      +              "type": "string"
      +            },
      +            "report_id": {
      +              "type": "string"
      +            }
      +          },
      +          "required": [
      +            "report_id",
      +            "outcome",
      +            "created_at"
      +          ],
      +          "type": "object"
      +        },
      +        "type": "array"
      +      },
      +      "reports_for_this_version": {
      +        "type": "number"
      +      },
      +      "reports_shown": {
      +        "type": "number"
      +      },
      +      "reports_truncated": {
      +        "const": true,
      +        "type": "boolean"
      +      },
      +      "security_status": {
      +        "enum": [
      +          "clear",
      +          "caution",
      +          "flagged",
      +          "confirmed_malicious",
      +          "unknown"
      +        ],
      +        "type": "string"
      +      },
      +      "share": {
      +        "additionalProperties": {},
      +        "properties": {
      +          "badge_markdown": {
      +            "type": [
      +              "string",
      +              "null"
      +            ]
      +          },
      +          "page_url": {
      +            "type": [
      +              "string",
      +              "null"
      +            ]
      +          },
      +          "receipt_badge_url": {
      +            "type": "string"
      +          },
      +          "receipt_markdown": {
      +            "type": "string"
      +          },
      +          "receipt_url": {
      +            "type": "string"
      +          }
      +        },
      +        "required": [
      +          "receipt_url"
      +        ],
      +        "type": "object"
      +      },
      +      "strain_hook_reports": {
      +        "type": "number"
      +      },
      +      "strain_reports": {
      +        "type": "number"
      +      },
      +      "summary": {
      +        "additionalProperties": {},
      +        "properties": {
      +          "advisories": {
      +            "type": "number"
      +          },
      +          "advisories_checked": {
      +            "type": "boolean"
      +          },
      +          "candidates": {
      +            "type": "number"
      +          },
      +          "exploited_in_wild": {
      +            "type": "number"
      +          },
      +          "field_reports": {
      +            "type": "number"
      +          },
      +          "forge_score": {
      +            "type": "number"
      +          },
      +          "known": {
      +            "type": "boolean"
      +          },
      +          "malicious": {
      +            "type": "number"
      +          },
      +          "other_versions_flagged": {
      +            "type": "number"
      +          },
      +          "people": {
      +            "type": "number"
      +          },
      +          "security_status": {
      +            "enum": [
      +              "clear",
      +              "caution",
      +              "flagged",
      +              "confirmed_malicious",
      +              "unknown"
      +            ],
      +            "type": "string"
      +          },
      +          "tool": {
      +            "type": "string"
      +          },
      +          "top_advisories": {
      +            "items": {
      +              "additionalProperties": {},
      +              "properties": {
      +                "cve": {
      +                  "type": "string"
      +                },
      +                "exploited_in_wild": {
      +                  "const": true,
      +                  "type": "boolean"
      +                },
      +                "fixed_in": {
      +                  "items": {
      +                    "type": "string"
      +                  },
      +                  "type": "array"
      +                },
      +                "id": {
      +                  "type": "string"
      +                },
      +                "kind": {
      +                  "enum": [
      +                    "malicious",
      +                    "vulnerability"
      +                  ],
      +                  "type": "string"
      +                }
      +              },
      +              "required": [
      +                "id",
      +                "kind"
      +              ],
      +              "type": "object"
      +            },
      +            "type": "array"
      +          },
      +          "verdict": {
      +            "enum": [
      +              "clear",
      +              "caution",
      +              "flagged",
      +              "confirmed_malicious",
      +              "insufficient"
      +            ],
      +            "type": "string"
      +          },
      +          "verified_people": {
      +            "type": "number"
      +          },
      +          "version": {
      +            "type": "string"
      +          }
      +        },
      +        "required": [
      +          "verdict",
      +          "security_status",
      +          "known",
      +          "tool",
      +          "field_reports",
      +          "people",
      +          "verified_people",
      +          "advisories_checked"
      +        ],
      +        "type": "object"
      +      },
      +      "tool": {
      +        "anyOf": [
      +          {
      +            "additionalProperties": {},
      +            "properties": {
      +              "id": {
      +                "type": "string"
      +              },
      +              "kind": {
      +                "type": "string"
      +              }
      +            },
      +            "required": [
      +              "kind",
      +              "id"
      +            ],
      +            "type": "object"
      +          },
      +          {
      +            "type": "null"
      +          }
      +        ]
      +      },
      +      "verdict": {
      +        "enum": [
      +          "clear",
      +          "caution",
      +          "flagged",
      +          "confirmed_malicious",
      +          "insufficient"
      +        ],
      +        "type": "string"
      +      },
      +      "verified_owners": {
      +        "type": "number"
      +      },
      +      "version": {
      +        "type": [
      +          "string",
      +          "null"
      +        ]
      +      }
      +    },
      +    "required": [
      +      "summary",
      +      "known",
      +      "distinct_owners",
      +      "verified_owners",
      +      "outcome_breakdown",
      +      "security_status",
      +      "verdict",
      +      "reports_for_this_version",
      +      "be_first",
      +      "contribute",
      +      "corroborated_reports",
      +      "share"
      +    ],
      +    "type": "object"
      +  },
      +  {
      +    "additionalProperties": {},
      +    "properties": {
      +      "data_kind": {
      +        "const": "input_needed",
      +        "type": "string"
      +      },
      +      "detail": {
      +        "type": [
      +          "string",
      +          "null"
      +        ]
      +      },
      +      "error": {
      +        "type": "string"
      +      },
      +      "examples": {
      +        "items": {
      +          "additionalProperties": {},
      +          "propertyNames": {
      +            "type": "string"
      +          },
      +          "type": "object"
      +        },
      +        "type": "array"
      +      },
      +      "needed": {
      +        "type": "string"
      +      },
      +      "tool": {
      +        "type": "string"
      +      }
      +    },
      +    "required": [
      +      "error",
      +      "data_kind",
      +      "tool",
      +      "needed",
      +      "detail",
      +      "examples"
      +    ],
      +    "type": "object"
      +  },
      +  {
      +    "additionalProperties": {},
      +    "properties": {
      +      "error": {
      +        "const": "rate_limited",
      +        "type": "string"
      +      },
      +      "limit": {
      +        "additionalProperties": {},
      +        "properties": {
      +          "per_minute": {
      +            "type": [
      +              "number",
      +              "null"
      +            ]
      +          },
      +          "per_month": {
      +            "type": [
      +              "number",
      +              "null"
      +            ]
      +          },
      +          "plan": {
      +            "enum": [
      +              "anonymous",
      +              "free",
      +              "team",
      +              "volume",
      +              "enterprise"
      +            ],
      +            "type": "string"
      +          },
      +          "resets_at": {
      +            "type": "string"
      +          },
      +          "used_this_month": {
      +            "type": "number"
      +          }
      +        },
      +        "required": [
      +          "plan",
      +          "per_minute"
      +        ],
      +        "type": "object"
      +      },
      +      "reason": {
      +        "enum": [
      +          "per_ip_minute",
      +          "per_key_minute",
      +          "monthly_quota"
      +        ],
      +        "type": "string"
      +      },
      +      "retry_after_s": {
      +        "type": "number"
      +      },
      +      "upgrade": {
      +        "additionalProperties": {},
      +        "properties": {
      +          "contact": {
      +            "type": "string"
      +          },
      +          "free_key": {
      +            "additionalProperties": {},
      +            "properties": {
      +              "per_minute": {
      +                "type": [
      +                  "number",
      +                  "null"
      +                ]
      +              },
      +              "per_month": {
      +                "type": [
      +                  "number",
      +                  "null"
      +                ]
      +              }
      +            },
      +            "required": [
      +              "per_minute",
      +              "per_month"
      +            ],
      +            "type": "object"
      +          },
      +          "keys_url": {
      +            "type": "string"
      +          },
      +          "paid_plans": {
      +            "enum": [
      +              "coming_soon",
      +              "available"
      +            ],
      +            "type": "string"
      +          },
      +          "plans": {
      +            "items": {
      +              "enum": [
      +                "team",
      +                "volume"
      +              ],
      +              "type": "string"
      +            },
      +            "type": "array"
      +          },
      +          "url": {
      +            "type": "string"
      +          }
      +        },
      +        "required": [
      +          "url",
      +          "keys_url",
      +          "plans",
      +          "paid_plans"
      +        ],
      +        "type": "object"
      +      }
      +    },
      +    "required": [
      +      "error",
      +      "retry_after_s"
      +    ],
      +    "type": "object"
      +  }
      +]
  2. Changed1 schema field changed
    • changedOutput schema / anyOf
      Previous value: -[
      -  {
      -    "additionalProperties": {},
      -    "properties": {
      -      "asked_version": {
      -        "type": "string"
      -      },
      -      "be_first": {
      -        "type": "boolean"
      -      },
      -      "candidates": {
      -        "items": {
      -          "additionalProperties": {},
      -          "properties": {
      -            "id": {
      -              "type": "string"
      -            },
      -            "page_url": {
      -              "type": "string"
      -            }
      -          },
      -          "required": [
      -            "id",
      -            "page_url"
      -          ],
      -          "type": "object"
      -        },
      -        "type": "array"
      -      },
      -      "contribute": {
      -        "additionalProperties": {},
      -        "properties": {
      -          "auth": {
      -            "const": "github_oauth",
      -            "type": "string"
      -          },
      -          "human_verified": {
      -            "const": true,
      -            "type": "boolean"
      -          },
      -          "mcp_server": {
      -            "type": "string"
      -          },
      -          "report_url": {
      -            "type": [
      -              "string",
      -              "null"
      -            ]
      -          },
      -          "tool": {
      -            "const": "forge_report",
      -            "type": "string"
      -          }
      -        },
      -        "required": [
      -          "tool",
      -          "mcp_server",
      -          "auth",
      -          "human_verified"
      -        ],
      -        "type": "object"
      -      },
      -      "corroborated_reports": {
      -        "type": "number"
      -      },
      -      "distinct_owners": {
      -        "type": "number"
      -      },
      -      "fingerprint": {
      -        "type": [
      -          "string",
      -          "null"
      -        ]
      -      },
      -      "forge_score": {
      -        "type": [
      -          "number",
      -          "null"
      -        ]
      -      },
      -      "known": {
      -        "type": "boolean"
      -      },
      -      "loop_rate": {
      -        "type": [
      -          "number",
      -          "null"
      -        ]
      -      },
      -      "other_versions_flagged": {
      -        "items": {
      -          "additionalProperties": {},
      -          "properties": {
      -            "security_status": {
      -              "enum": [
      -                "clear",
      -                "caution",
      -                "flagged",
      -                "confirmed_malicious",
      -                "unknown"
      -              ],
      -              "type": "string"
      -            },
      -            "version": {
      -              "type": "string"
      -            }
      -          },
      -          "required": [
      -            "version",
      -            "security_status"
      -          ],
      -          "type": "object"
      -        },
      -        "type": "array"
      -      },
      -      "outcome_breakdown": {
      -        "additionalProperties": {},
      -        "properties": {
      -          "failed": {
      -            "type": "number"
      -          },
      -          "partial": {
      -            "type": "number"
      -          },
      -          "worked": {
      -            "type": "number"
      -          }
      -        },
      -        "required": [
      -          "worked",
      -          "partial",
      -          "failed"
      -        ],
      -        "type": "object"
      -      },
      -      "page_url": {
      -        "type": [
      -          "string",
      -          "null"
      -        ]
      -      },
      -      "public_signals_summary": {
      -        "anyOf": [
      -          {
      -            "additionalProperties": {},
      -            "properties": {
      -              "advisories": {
      -                "items": {
      -                  "additionalProperties": {},
      -                  "properties": {
      -                    "affects_version": {
      -                      "type": [
      -                        "boolean",
      -                        "null"
      -                      ]
      -                    },
      -                    "aliases": {
      -                      "items": {
      -                        "type": "string"
      -                      },
      -                      "type": "array"
      -                    },
      -                    "exploited_in_wild": {
      -                      "type": "boolean"
      -                    },
      -                    "fixed": {
      -                      "items": {
      -                        "type": "string"
      -                      },
      -                      "type": "array"
      -                    },
      -                    "id": {
      -                      "type": "string"
      -                    },
      -                    "kind": {
      -                      "enum": [
      -                        "malicious",
      -                        "vulnerability"
      -                      ],
      -                      "type": "string"
      -                    },
      -                    "modified": {
      -                      "type": [
      -                        "string",
      -                        "null"
      -                      ]
      -                    },
      -                    "published": {
      -                      "type": [
      -                        "string",
      -                        "null"
      -                      ]
      -                    },
      -                    "url": {
      -                      "type": "string"
      -                    }
      -                  },
      -                  "required": [
      -                    "id",
      -                    "kind",
      -                    "aliases",
      -                    "fixed",
      -                    "url"
      -                  ],
      -                  "type": "object"
      -                },
      -                "type": "array"
      -              },
      -              "checked_at": {
      -                "type": "string"
      -              },
      -              "ecosystem": {
      -                "type": "string"
      -              },
      -              "full_list_url": {
      -                "type": "string"
      -              },
      -              "kev_as_of": {
      -                "type": [
      -                  "string",
      -                  "null"
      -                ]
      -              },
      -              "package": {
      -                "type": "string"
      -              },
      -              "shown": {
      -                "type": "number"
      -              },
      -              "source": {
      -                "const": "osv",
      -                "type": "string"
      -              },
      -              "total": {
      -                "type": "number"
      -              },
      -              "truncated": {
      -                "const": true,
      -                "type": "boolean"
      -              },
      -              "version": {
      -                "type": [
      -                  "string",
      -                  "null"
      -                ]
      -              }
      -            },
      -            "required": [
      -              "source",
      -              "ecosystem",
      -              "package",
      -              "version",
      -              "checked_at",
      -              "total",
      -              "advisories"
      -            ],
      -            "type": "object"
      -          },
      -          {
      -            "type": "null"
      -          }
      -        ]
      -      },
      -      "recovers_after_reset_rate": {
      -        "type": [
      -          "number",
      -          "null"
      -        ]
      -      },
      -      "related": {
      -        "items": {
      -          "additionalProperties": {},
      -          "properties": {
      -            "arguments": {
      -              "additionalProperties": {},
      -              "propertyNames": {
      -                "type": "string"
      -              },
      -              "type": "object"
      -            },
      -            "mcp_server": {
      -              "type": "string"
      -            },
      -            "relation": {
      -              "enum": [
      -                "full_answer",
      -                "scan_skill_file",
      -                "candidate",
      -                "watch_fingerprint",
      -                "check_match",
      -                "rescan"
      -              ],
      -              "type": "string"
      -            },
      -            "tool": {
      -              "enum": [
      -                "forge_check",
      -                "forge_scan",
      -                "forge_watch"
      -              ],
      -              "type": "string"
      -            }
      -          },
      -          "required": [
      -            "relation",
      -            "tool",
      -            "arguments"
      -          ],
      -          "type": "object"
      -        },
      -        "type": "array"
      -      },
      -      "reports": {
      -        "items": {
      -          "additionalProperties": {},
      -          "properties": {
      -            "created_at": {
      -              "type": "string"
      -            },
      -            "outcome": {
      -              "enum": [
      -                "worked",
      -                "partial",
      -                "failed"
      -              ],
      -              "type": "string"
      -            },
      -            "report_id": {
      -              "type": "string"
      -            }
      -          },
      -          "required": [
      -            "report_id",
      -            "outcome",
      -            "created_at"
      -          ],
      -          "type": "object"
      -        },
      -        "type": "array"
      -      },
      -      "reports_for_this_version": {
      -        "type": "number"
      -      },
      -      "reports_shown": {
      -        "type": "number"
      -      },
      -      "reports_truncated": {
      -        "const": true,
      -        "type": "boolean"
      -      },
      -      "security_status": {
      -        "enum": [
      -          "clear",
      -          "caution",
      -          "flagged",
      -          "confirmed_malicious",
      -          "unknown"
      -        ],
      -        "type": "string"
      -      },
      -      "share": {
      -        "additionalProperties": {},
      -        "properties": {
      -          "badge_markdown": {
      -            "type": [
      -              "string",
      -              "null"
      -            ]
      -          },
      -          "page_url": {
      -            "type": [
      -              "string",
      -              "null"
      -            ]
      -          },
      -          "receipt_badge_url": {
      -            "type": "string"
      -          },
      -          "receipt_markdown": {
      -            "type": "string"
      -          },
      -          "receipt_url": {
      -            "type": "string"
      -          }
      -        },
      -        "required": [
      -          "receipt_url"
      -        ],
      -        "type": "object"
      -      },
      -      "strain_hook_reports": {
      -        "type": "number"
      -      },
      -      "strain_reports": {
      -        "type": "number"
      -      },
      -      "summary": {
      -        "additionalProperties": {},
      -        "properties": {
      -          "advisories": {
      -            "type": "number"
      -          },
      -          "advisories_checked": {
      -            "type": "boolean"
      -          },
      -          "candidates": {
      -            "type": "number"
      -          },
      -          "exploited_in_wild": {
      -            "type": "number"
      -          },
      -          "field_reports": {
      -            "type": "number"
      -          },
      -          "forge_score": {
      -            "type": "number"
      -          },
      -          "known": {
      -            "type": "boolean"
      -          },
      -          "malicious": {
      -            "type": "number"
      -          },
      -          "other_versions_flagged": {
      -            "type": "number"
      -          },
      -          "people": {
      -            "type": "number"
      -          },
      -          "security_status": {
      -            "enum": [
      -              "clear",
      -              "caution",
      -              "flagged",
      -              "confirmed_malicious",
      -              "unknown"
      -            ],
      -            "type": "string"
      -          },
      -          "tool": {
      -            "type": "string"
      -          },
      -          "top_advisories": {
      -            "items": {
      -              "additionalProperties": {},
      -              "properties": {
      -                "cve": {
      -                  "type": "string"
      -                },
      -                "exploited_in_wild": {
      -                  "const": true,
      -                  "type": "boolean"
      -                },
      -                "fixed_in": {
      -                  "items": {
      -                    "type": "string"
      -                  },
      -                  "type": "array"
      -                },
      -                "id": {
      -                  "type": "string"
      -                },
      -                "kind": {
      -                  "enum": [
      -                    "malicious",
      -                    "vulnerability"
      -                  ],
      -                  "type": "string"
      -                }
      -              },
      -              "required": [
      -                "id",
      -                "kind"
      -              ],
      -              "type": "object"
      -            },
      -            "type": "array"
      -          },
      -          "verdict": {
      -            "enum": [
      -              "clear",
      -              "caution",
      -              "flagged",
      -              "confirmed_malicious",
      -              "insufficient"
      -            ],
      -            "type": "string"
      -          },
      -          "verified_people": {
      -            "type": "number"
      -          },
      -          "version": {
      -            "type": "string"
      -          }
      -        },
      -        "required": [
      -          "verdict",
      -          "security_status",
      -          "known",
      -          "tool",
      -          "field_reports",
      -          "people",
      -          "verified_people",
      -          "advisories_checked"
      -        ],
      -        "type": "object"
      -      },
      -      "tool": {
      -        "anyOf": [
      -          {
      -            "additionalProperties": {},
      -            "properties": {
      -              "id": {
      -                "type": "string"
      -              },
      -              "kind": {
      -                "type": "string"
      -              }
      -            },
      -            "required": [
      -              "kind",
      -              "id"
      -            ],
      -            "type": "object"
      -          },
      -          {
      -            "type": "null"
      -          }
      -        ]
      -      },
      -      "verdict": {
      -        "enum": [
      -          "clear",
      -          "caution",
      -          "flagged",
      -          "confirmed_malicious",
      -          "insufficient"
      -        ],
      -        "type": "string"
      -      },
      -      "verified_owners": {
      -        "type": "number"
      -      },
      -      "version": {
      -        "type": [
      -          "string",
      -          "null"
      -        ]
      -      }
      -    },
      -    "required": [
      -      "summary",
      -      "known",
      -      "distinct_owners",
      -      "verified_owners",
      -      "outcome_breakdown",
      -      "security_status",
      -      "verdict",
      -      "reports_for_this_version",
      -      "be_first",
      -      "contribute",
      -      "corroborated_reports",
      -      "share"
      -    ],
      -    "type": "object"
      -  },
      -  {
      -    "additionalProperties": {},
      -    "properties": {
      -      "data_kind": {
      -        "const": "input_needed",
      -        "type": "string"
      -      },
      -      "detail": {
      -        "type": [
      -          "string",
      -          "null"
      -        ]
      -      },
      -      "error": {
      -        "type": "string"
      -      },
      -      "examples": {
      -        "items": {
      -          "additionalProperties": {},
      -          "propertyNames": {
      -            "type": "string"
      -          },
      -          "type": "object"
      -        },
      -        "type": "array"
      -      },
      -      "needed": {
      -        "type": "string"
      -      },
      -      "tool": {
      -        "type": "string"
      -      }
      -    },
      -    "required": [
      -      "error",
      -      "data_kind",
      -      "tool",
      -      "needed",
      -      "detail",
      -      "examples"
      -    ],
      -    "type": "object"
      -  },
      -  {
      -    "additionalProperties": {},
      -    "properties": {
      -      "error": {
      -        "const": "rate_limited",
      -        "type": "string"
      -      },
      -      "retry_after_s": {
      -        "type": "number"
      -      }
      -    },
      -    "required": [
      -      "error",
      -      "retry_after_s"
      -    ],
      -    "type": "object"
      -  }
      -]New value: +[
      +  {
      +    "additionalProperties": {},
      +    "properties": {
      +      "asked_version": {
      +        "type": "string"
      +      },
      +      "be_first": {
      +        "type": "boolean"
      +      },
      +      "candidates": {
      +        "items": {
      +          "additionalProperties": {},
      +          "properties": {
      +            "id": {
      +              "type": "string"
      +            },
      +            "page_url": {
      +              "type": "string"
      +            }
      +          },
      +          "required": [
      +            "id",
      +            "page_url"
      +          ],
      +          "type": "object"
      +        },
      +        "type": "array"
      +      },
      +      "contribute": {
      +        "additionalProperties": {},
      +        "properties": {
      +          "auth": {
      +            "const": "github_oauth",
      +            "type": "string"
      +          },
      +          "human_verified": {
      +            "const": true,
      +            "type": "boolean"
      +          },
      +          "mcp_server": {
      +            "type": "string"
      +          },
      +          "report_url": {
      +            "type": [
      +              "string",
      +              "null"
      +            ]
      +          },
      +          "tool": {
      +            "const": "forge_report",
      +            "type": "string"
      +          }
      +        },
      +        "required": [
      +          "tool",
      +          "mcp_server",
      +          "auth",
      +          "human_verified"
      +        ],
      +        "type": "object"
      +      },
      +      "corroborated_reports": {
      +        "type": "number"
      +      },
      +      "distinct_owners": {
      +        "type": "number"
      +      },
      +      "fingerprint": {
      +        "type": [
      +          "string",
      +          "null"
      +        ]
      +      },
      +      "forge_score": {
      +        "type": [
      +          "number",
      +          "null"
      +        ]
      +      },
      +      "known": {
      +        "type": "boolean"
      +      },
      +      "loop_rate": {
      +        "type": [
      +          "number",
      +          "null"
      +        ]
      +      },
      +      "other_versions_flagged": {
      +        "items": {
      +          "additionalProperties": {},
      +          "properties": {
      +            "security_status": {
      +              "enum": [
      +                "clear",
      +                "caution",
      +                "flagged",
      +                "confirmed_malicious",
      +                "unknown"
      +              ],
      +              "type": "string"
      +            },
      +            "version": {
      +              "type": "string"
      +            }
      +          },
      +          "required": [
      +            "version",
      +            "security_status"
      +          ],
      +          "type": "object"
      +        },
      +        "type": "array"
      +      },
      +      "outcome_breakdown": {
      +        "additionalProperties": {},
      +        "properties": {
      +          "failed": {
      +            "type": "number"
      +          },
      +          "partial": {
      +            "type": "number"
      +          },
      +          "worked": {
      +            "type": "number"
      +          }
      +        },
      +        "required": [
      +          "worked",
      +          "partial",
      +          "failed"
      +        ],
      +        "type": "object"
      +      },
      +      "page_url": {
      +        "type": [
      +          "string",
      +          "null"
      +        ]
      +      },
      +      "public_signals_summary": {
      +        "anyOf": [
      +          {
      +            "additionalProperties": {},
      +            "properties": {
      +              "advisories": {
      +                "items": {
      +                  "additionalProperties": {},
      +                  "properties": {
      +                    "affects_version": {
      +                      "type": [
      +                        "boolean",
      +                        "null"
      +                      ]
      +                    },
      +                    "aliases": {
      +                      "items": {
      +                        "type": "string"
      +                      },
      +                      "type": "array"
      +                    },
      +                    "exploited_in_wild": {
      +                      "type": "boolean"
      +                    },
      +                    "fixed": {
      +                      "items": {
      +                        "type": "string"
      +                      },
      +                      "type": "array"
      +                    },
      +                    "id": {
      +                      "type": "string"
      +                    },
      +                    "kind": {
      +                      "enum": [
      +                        "malicious",
      +                        "vulnerability"
      +                      ],
      +                      "type": "string"
      +                    },
      +                    "modified": {
      +                      "type": [
      +                        "string",
      +                        "null"
      +                      ]
      +                    },
      +                    "published": {
      +                      "type": [
      +                        "string",
      +                        "null"
      +                      ]
      +                    },
      +                    "url": {
      +                      "type": "string"
      +                    }
      +                  },
      +                  "required": [
      +                    "id",
      +                    "kind",
      +                    "aliases",
      +                    "fixed",
      +                    "url"
      +                  ],
      +                  "type": "object"
      +                },
      +                "type": "array"
      +              },
      +              "checked_at": {
      +                "type": "string"
      +              },
      +              "ecosystem": {
      +                "type": "string"
      +              },
      +              "full_list_url": {
      +                "type": "string"
      +              },
      +              "kev_as_of": {
      +                "type": [
      +                  "string",
      +                  "null"
      +                ]
      +              },
      +              "package": {
      +                "type": "string"
      +              },
      +              "shown": {
      +                "type": "number"
      +              },
      +              "source": {
      +                "const": "osv",
      +                "type": "string"
      +              },
      +              "total": {
      +                "type": "number"
      +              },
      +              "truncated": {
      +                "const": true,
      +                "type": "boolean"
      +              },
      +              "version": {
      +                "type": [
      +                  "string",
      +                  "null"
      +                ]
      +              }
      +            },
      +            "required": [
      +              "source",
      +              "ecosystem",
      +              "package",
      +              "version",
      +              "checked_at",
      +              "total",
      +              "advisories"
      +            ],
      +            "type": "object"
      +          },
      +          {
      +            "type": "null"
      +          }
      +        ]
      +      },
      +      "recovers_after_reset_rate": {
      +        "type": [
      +          "number",
      +          "null"
      +        ]
      +      },
      +      "related": {
      +        "items": {
      +          "additionalProperties": {},
      +          "properties": {
      +            "arguments": {
      +              "additionalProperties": {},
      +              "propertyNames": {
      +                "type": "string"
      +              },
      +              "type": "object"
      +            },
      +            "mcp_server": {
      +              "type": "string"
      +            },
      +            "relation": {
      +              "enum": [
      +                "full_answer",
      +                "scan_skill_file",
      +                "candidate",
      +                "watch_fingerprint",
      +                "check_match",
      +                "rescan"
      +              ],
      +              "type": "string"
      +            },
      +            "tool": {
      +              "enum": [
      +                "forge_check",
      +                "forge_scan",
      +                "forge_watch"
      +              ],
      +              "type": "string"
      +            }
      +          },
      +          "required": [
      +            "relation",
      +            "tool",
      +            "arguments"
      +          ],
      +          "type": "object"
      +        },
      +        "type": "array"
      +      },
      +      "reports": {
      +        "items": {
      +          "additionalProperties": {},
      +          "properties": {
      +            "created_at": {
      +              "type": "string"
      +            },
      +            "outcome": {
      +              "enum": [
      +                "worked",
      +                "partial",
      +                "failed"
      +              ],
      +              "type": "string"
      +            },
      +            "report_id": {
      +              "type": "string"
      +            }
      +          },
      +          "required": [
      +            "report_id",
      +            "outcome",
      +            "created_at"
      +          ],
      +          "type": "object"
      +        },
      +        "type": "array"
      +      },
      +      "reports_for_this_version": {
      +        "type": "number"
      +      },
      +      "reports_shown": {
      +        "type": "number"
      +      },
      +      "reports_truncated": {
      +        "const": true,
      +        "type": "boolean"
      +      },
      +      "security_status": {
      +        "enum": [
      +          "clear",
      +          "caution",
      +          "flagged",
      +          "confirmed_malicious",
      +          "unknown"
      +        ],
      +        "type": "string"
      +      },
      +      "share": {
      +        "additionalProperties": {},
      +        "properties": {
      +          "badge_markdown": {
      +            "type": [
      +              "string",
      +              "null"
      +            ]
      +          },
      +          "page_url": {
      +            "type": [
      +              "string",
      +              "null"
      +            ]
      +          },
      +          "receipt_badge_url": {
      +            "type": "string"
      +          },
      +          "receipt_markdown": {
      +            "type": "string"
      +          },
      +          "receipt_url": {
      +            "type": "string"
      +          }
      +        },
      +        "required": [
      +          "receipt_url"
      +        ],
      +        "type": "object"
      +      },
      +      "strain_hook_reports": {
      +        "type": "number"
      +      },
      +      "strain_reports": {
      +        "type": "number"
      +      },
      +      "summary": {
      +        "additionalProperties": {},
      +        "properties": {
      +          "advisories": {
      +            "type": "number"
      +          },
      +          "advisories_checked": {
      +            "type": "boolean"
      +          },
      +          "candidates": {
      +            "type": "number"
      +          },
      +          "exploited_in_wild": {
      +            "type": "number"
      +          },
      +          "field_reports": {
      +            "type": "number"
      +          },
      +          "forge_score": {
      +            "type": "number"
      +          },
      +          "known": {
      +            "type": "boolean"
      +          },
      +          "malicious": {
      +            "type": "number"
      +          },
      +          "other_versions_flagged": {
      +            "type": "number"
      +          },
      +          "people": {
      +            "type": "number"
      +          },
      +          "security_status": {
      +            "enum": [
      +              "clear",
      +              "caution",
      +              "flagged",
      +              "confirmed_malicious",
      +              "unknown"
      +            ],
      +            "type": "string"
      +          },
      +          "tool": {
      +            "type": "string"
      +          },
      +          "top_advisories": {
      +            "items": {
      +              "additionalProperties": {},
      +              "properties": {
      +                "cve": {
      +                  "type": "string"
      +                },
      +                "exploited_in_wild": {
      +                  "const": true,
      +                  "type": "boolean"
      +                },
      +                "fixed_in": {
      +                  "items": {
      +                    "type": "string"
      +                  },
      +                  "type": "array"
      +                },
      +                "id": {
      +                  "type": "string"
      +                },
      +                "kind": {
      +                  "enum": [
      +                    "malicious",
      +                    "vulnerability"
      +                  ],
      +                  "type": "string"
      +                }
      +              },
      +              "required": [
      +                "id",
      +                "kind"
      +              ],
      +              "type": "object"
      +            },
      +            "type": "array"
      +          },
      +          "verdict": {
      +            "enum": [
      +              "clear",
      +              "caution",
      +              "flagged",
      +              "confirmed_malicious",
      +              "insufficient"
      +            ],
      +            "type": "string"
      +          },
      +          "verified_people": {
      +            "type": "number"
      +          },
      +          "version": {
      +            "type": "string"
      +          }
      +        },
      +        "required": [
      +          "verdict",
      +          "security_status",
      +          "known",
      +          "tool",
      +          "field_reports",
      +          "people",
      +          "verified_people",
      +          "advisories_checked"
      +        ],
      +        "type": "object"
      +      },
      +      "tool": {
      +        "anyOf": [
      +          {
      +            "additionalProperties": {},
      +            "properties": {
      +              "id": {
      +                "type": "string"
      +              },
      +              "kind": {
      +                "type": "string"
      +              }
      +            },
      +            "required": [
      +              "kind",
      +              "id"
      +            ],
      +            "type": "object"
      +          },
      +          {
      +            "type": "null"
      +          }
      +        ]
      +      },
      +      "verdict": {
      +        "enum": [
      +          "clear",
      +          "caution",
      +          "flagged",
      +          "confirmed_malicious",
      +          "insufficient"
      +        ],
      +        "type": "string"
      +      },
      +      "verified_owners": {
      +        "type": "number"
      +      },
      +      "version": {
      +        "type": [
      +          "string",
      +          "null"
      +        ]
      +      }
      +    },
      +    "required": [
      +      "summary",
      +      "known",
      +      "distinct_owners",
      +      "verified_owners",
      +      "outcome_breakdown",
      +      "security_status",
      +      "verdict",
      +      "reports_for_this_version",
      +      "be_first",
      +      "contribute",
      +      "corroborated_reports",
      +      "share"
      +    ],
      +    "type": "object"
      +  },
      +  {
      +    "additionalProperties": {},
      +    "properties": {
      +      "data_kind": {
      +        "const": "input_needed",
      +        "type": "string"
      +      },
      +      "detail": {
      +        "type": [
      +          "string",
      +          "null"
      +        ]
      +      },
      +      "error": {
      +        "type": "string"
      +      },
      +      "examples": {
      +        "items": {
      +          "additionalProperties": {},
      +          "propertyNames": {
      +            "type": "string"
      +          },
      +          "type": "object"
      +        },
      +        "type": "array"
      +      },
      +      "needed": {
      +        "type": "string"
      +      },
      +      "tool": {
      +        "type": "string"
      +      }
      +    },
      +    "required": [
      +      "error",
      +      "data_kind",
      +      "tool",
      +      "needed",
      +      "detail",
      +      "examples"
      +    ],
      +    "type": "object"
      +  },
      +  {
      +    "additionalProperties": {},
      +    "properties": {
      +      "error": {
      +        "const": "rate_limited",
      +        "type": "string"
      +      },
      +      "limit": {
      +        "additionalProperties": {},
      +        "properties": {
      +          "per_minute": {
      +            "type": [
      +              "number",
      +              "null"
      +            ]
      +          },
      +          "per_month": {
      +            "type": [
      +              "number",
      +              "null"
      +            ]
      +          },
      +          "plan": {
      +            "enum": [
      +              "anonymous",
      +              "free",
      +              "team",
      +              "volume",
      +              "enterprise"
      +            ],
      +            "type": "string"
      +          },
      +          "resets_at": {
      +            "type": "string"
      +          },
      +          "used_this_month": {
      +            "type": "number"
      +          }
      +        },
      +        "required": [
      +          "plan",
      +          "per_minute"
      +        ],
      +        "type": "object"
      +      },
      +      "reason": {
      +        "enum": [
      +          "per_ip_minute",
      +          "per_key_minute",
      +          "monthly_quota"
      +        ],
      +        "type": "string"
      +      },
      +      "retry_after_s": {
      +        "type": "number"
      +      },
      +      "upgrade": {
      +        "additionalProperties": {},
      +        "properties": {
      +          "contact": {
      +            "type": "string"
      +          },
      +          "free_key": {
      +            "additionalProperties": {},
      +            "properties": {
      +              "per_minute": {
      +                "type": [
      +                  "number",
      +                  "null"
      +                ]
      +              },
      +              "per_month": {
      +                "type": [
      +                  "number",
      +                  "null"
      +                ]
      +              }
      +            },
      +            "required": [
      +              "per_minute",
      +              "per_month"
      +            ],
      +            "type": "object"
      +          },
      +          "keys_url": {
      +            "type": "string"
      +          },
      +          "paid_plans": {
      +            "enum": [
      +              "coming_soon",
      +              "available"
      +            ],
      +            "type": "string"
      +          },
      +          "plans": {
      +            "items": {
      +              "enum": [
      +                "team",
      +                "volume"
      +              ],
      +              "type": "string"
      +            },
      +            "type": "array"
      +          },
      +          "url": {
      +            "type": "string"
      +          }
      +        },
      +        "required": [
      +          "url",
      +          "keys_url",
      +          "plans",
      +          "paid_plans"
      +        ],
      +        "type": "object"
      +      }
      +    },
      +    "required": [
      +      "error",
      +      "retry_after_s"
      +    ],
      +    "type": "object"
      +  }
      +]
  3. Changed2 schema fields changed
    • addedInput schema / properties / detail
      Added value: +{
      +  "description": "compact (default): summary first, top advisories, capped lists; full: every advisory and field",
      +  "enum": [
      +    "compact",
      +    "full"
      +  ],
      +  "type": "string"
      +}
    • changedOutput schema / (root)
      Previous value: -nullNew value: +{
      +  "$schema": "https://json-schema.org/draft/2020-12/schema",
      +  "anyOf": [
      +    {
      +      "additionalProperties": {},
      +      "properties": {
      +        "asked_version": {
      +          "type": "string"
      +        },
      +        "be_first": {
      +          "type": "boolean"
      +        },
      +        "candidates": {
      +          "items": {
      +            "additionalProperties": {},
      +            "properties": {
      +              "id": {
      +                "type": "string"
      +              },
      +              "page_url": {
      +                "type": "string"
      +              }
      +            },
      +            "required": [
      +              "id",
      +              "page_url"
      +            ],
      +            "type": "object"
      +          },
      +          "type": "array"
      +        },
      +        "contribute": {
      +          "additionalProperties": {},
      +          "properties": {
      +            "auth": {
      +              "const": "github_oauth",
      +              "type": "string"
      +            },
      +            "human_verified": {
      +              "const": true,
      +              "type": "boolean"
      +            },
      +            "mcp_server": {
      +              "type": "string"
      +            },
      +            "report_url": {
      +              "type": [
      +                "string",
      +                "null"
      +              ]
      +            },
      +            "tool": {
      +              "const": "forge_report",
      +              "type": "string"
      +            }
      +          },
      +          "required": [
      +            "tool",
      +            "mcp_server",
      +            "auth",
      +            "human_verified"
      +          ],
      +          "type": "object"
      +        },
      +        "corroborated_reports": {
      +          "type": "number"
      +        },
      +        "distinct_owners": {
      +          "type": "number"
      +        },
      +        "fingerprint": {
      +          "type": [
      +            "string",
      +            "null"
      +          ]
      +        },
      +        "forge_score": {
      +          "type": [
      +            "number",
      +            "null"
      +          ]
      +        },
      +        "known": {
      +          "type": "boolean"
      +        },
      +        "loop_rate": {
      +          "type": [
      +            "number",
      +            "null"
      +          ]
      +        },
      +        "other_versions_flagged": {
      +          "items": {
      +            "additionalProperties": {},
      +            "properties": {
      +              "security_status": {
      +                "enum": [
      +                  "clear",
      +                  "caution",
      +                  "flagged",
      +                  "confirmed_malicious",
      +                  "unknown"
      +                ],
      +                "type": "string"
      +              },
      +              "version": {
      +                "type": "string"
      +              }
      +            },
      +            "required": [
      +              "version",
      +              "security_status"
      +            ],
      +            "type": "object"
      +          },
      +          "type": "array"
      +        },
      +        "outcome_breakdown": {
      +          "additionalProperties": {},
      +          "properties": {
      +            "failed": {
      +              "type": "number"
      +            },
      +            "partial": {
      +              "type": "number"
      +            },
      +            "worked": {
      +              "type": "number"
      +            }
      +          },
      +          "required": [
      +            "worked",
      +            "partial",
      +            "failed"
      +          ],
      +          "type": "object"
      +        },
      +        "page_url": {
      +          "type": [
      +            "string",
      +            "null"
      +          ]
      +        },
      +        "public_signals_summary": {
      +          "anyOf": [
      +            {
      +              "additionalProperties": {},
      +              "properties": {
      +                "advisories": {
      +                  "items": {
      +                    "additionalProperties": {},
      +                    "properties": {
      +                      "affects_version": {
      +                        "type": [
      +                          "boolean",
      +                          "null"
      +                        ]
      +                      },
      +                      "aliases": {
      +                        "items": {
      +                          "type": "string"
      +                        },
      +                        "type": "array"
      +                      },
      +                      "exploited_in_wild": {
      +                        "type": "boolean"
      +                      },
      +                      "fixed": {
      +                        "items": {
      +                          "type": "string"
      +                        },
      +                        "type": "array"
      +                      },
      +                      "id": {
      +                        "type": "string"
      +                      },
      +                      "kind": {
      +                        "enum": [
      +                          "malicious",
      +                          "vulnerability"
      +                        ],
      +                        "type": "string"
      +                      },
      +                      "modified": {
      +                        "type": [
      +                          "string",
      +                          "null"
      +                        ]
      +                      },
      +                      "published": {
      +                        "type": [
      +                          "string",
      +                          "null"
      +                        ]
      +                      },
      +                      "url": {
      +                        "type": "string"
      +                      }
      +                    },
      +                    "required": [
      +                      "id",
      +                      "kind",
      +                      "aliases",
      +                      "fixed",
      +                      "url"
      +                    ],
      +                    "type": "object"
      +                  },
      +                  "type": "array"
      +                },
      +                "checked_at": {
      +                  "type": "string"
      +                },
      +                "ecosystem": {
      +                  "type": "string"
      +                },
      +                "full_list_url": {
      +                  "type": "string"
      +                },
      +                "kev_as_of": {
      +                  "type": [
      +                    "string",
      +                    "null"
      +                  ]
      +                },
      +                "package": {
      +                  "type": "string"
      +                },
      +                "shown": {
      +                  "type": "number"
      +                },
      +                "source": {
      +                  "const": "osv",
      +                  "type": "string"
      +                },
      +                "total": {
      +                  "type": "number"
      +                },
      +                "truncated": {
      +                  "const": true,
      +                  "type": "boolean"
      +                },
      +                "version": {
      +                  "type": [
      +                    "string",
      +                    "null"
      +                  ]
      +                }
      +              },
      +              "required": [
      +                "source",
      +                "ecosystem",
      +                "package",
      +                "version",
      +                "checked_at",
      +                "total",
      +                "advisories"
      +              ],
      +              "type": "object"
      +            },
      +            {
      +              "type": "null"
      +            }
      +          ]
      +        },
      +        "recovers_after_reset_rate": {
      +          "type": [
      +            "number",
      +            "null"
      +          ]
      +        },
      +        "related": {
      +          "items": {
      +            "additionalProperties": {},
      +            "properties": {
      +              "arguments": {
      +                "additionalProperties": {},
      +                "propertyNames": {
      +                  "type": "string"
      +                },
      +                "type": "object"
      +              },
      +              "mcp_server": {
      +                "type": "string"
      +              },
      +              "relation": {
      +                "enum": [
      +                  "full_answer",
      +                  "scan_skill_file",
      +                  "candidate",
      +                  "watch_fingerprint",
      +                  "check_match",
      +                  "rescan"
      +                ],
      +                "type": "string"
      +              },
      +              "tool": {
      +                "enum": [
      +                  "forge_check",
      +                  "forge_scan",
      +                  "forge_watch"
      +                ],
      +                "type": "string"
      +              }
      +            },
      +            "required": [
      +              "relation",
      +              "tool",
      +              "arguments"
      +            ],
      +            "type": "object"
      +          },
      +          "type": "array"
      +        },
      +        "reports": {
      +          "items": {
      +            "additionalProperties": {},
      +            "properties": {
      +              "created_at": {
      +                "type": "string"
      +              },
      +              "outcome": {
      +                "enum": [
      +                  "worked",
      +                  "partial",
      +                  "failed"
      +                ],
      +                "type": "string"
      +              },
      +              "report_id": {
      +                "type": "string"
      +              }
      +            },
      +            "required": [
      +              "report_id",
      +              "outcome",
      +              "created_at"
      +            ],
      +            "type": "object"
      +          },
      +          "type": "array"
      +        },
      +        "reports_for_this_version": {
      +          "type": "number"
      +        },
      +        "reports_shown": {
      +          "type": "number"
      +        },
      +        "reports_truncated": {
      +          "const": true,
      +          "type": "boolean"
      +        },
      +        "security_status": {
      +          "enum": [
      +            "clear",
      +            "caution",
      +            "flagged",
      +            "confirmed_malicious",
      +            "unknown"
      +          ],
      +          "type": "string"
      +        },
      +        "share": {
      +          "additionalProperties": {},
      +          "properties": {
      +            "badge_markdown": {
      +              "type": [
      +                "string",
      +                "null"
      +              ]
      +            },
      +            "page_url": {
      +              "type": [
      +                "string",
      +                "null"
      +              ]
      +            },
      +            "receipt_badge_url": {
      +              "type": "string"
      +            },
      +            "receipt_markdown": {
      +              "type": "string"
      +            },
      +            "receipt_url": {
      +              "type": "string"
      +            }
      +          },
      +          "required": [
      +            "receipt_url"
      +          ],
      +          "type": "object"
      +        },
      +        "strain_hook_reports": {
      +          "type": "number"
      +        },
      +        "strain_reports": {
      +          "type": "number"
      +        },
      +        "summary": {
      +          "additionalProperties": {},
      +          "properties": {
      +            "advisories": {
      +              "type": "number"
      +            },
      +            "advisories_checked": {
      +              "type": "boolean"
      +            },
      +            "candidates": {
      +              "type": "number"
      +            },
      +            "exploited_in_wild": {
      +              "type": "number"
      +            },
      +            "field_reports": {
      +              "type": "number"
      +            },
      +            "forge_score": {
      +              "type": "number"
      +            },
      +            "known": {
      +              "type": "boolean"
      +            },
      +            "malicious": {
      +              "type": "number"
      +            },
      +            "other_versions_flagged": {
      +              "type": "number"
      +            },
      +            "people": {
      +              "type": "number"
      +            },
      +            "security_status": {
      +              "enum": [
      +                "clear",
      +                "caution",
      +                "flagged",
      +                "confirmed_malicious",
      +                "unknown"
      +              ],
      +              "type": "string"
      +            },
      +            "tool": {
      +              "type": "string"
      +            },
      +            "top_advisories": {
      +              "items": {
      +                "additionalProperties": {},
      +                "properties": {
      +                  "cve": {
      +                    "type": "string"
      +                  },
      +                  "exploited_in_wild": {
      +                    "const": true,
      +                    "type": "boolean"
      +                  },
      +                  "fixed_in": {
      +                    "items": {
      +                      "type": "string"
      +                    },
      +                    "type": "array"
      +                  },
      +                  "id": {
      +                    "type": "string"
      +                  },
      +                  "kind": {
      +                    "enum": [
      +                      "malicious",
      +                      "vulnerability"
      +                    ],
      +                    "type": "string"
      +                  }
      +                },
      +                "required": [
      +                  "id",
      +                  "kind"
      +                ],
      +                "type": "object"
      +              },
      +              "type": "array"
      +            },
      +            "verdict": {
      +              "enum": [
      +                "clear",
      +                "caution",
      +                "flagged",
      +                "confirmed_malicious",
      +                "insufficient"
      +              ],
      +              "type": "string"
      +            },
      +            "verified_people": {
      +              "type": "number"
      +            },
      +            "version": {
      +              "type": "string"
      +            }
      +          },
      +          "required": [
      +            "verdict",
      +            "security_status",
      +            "known",
      +            "tool",
      +            "field_reports",
      +            "people",
      +            "verified_people",
      +            "advisories_checked"
      +          ],
      +          "type": "object"
      +        },
      +        "tool": {
      +          "anyOf": [
      +            {
      +              "additionalProperties": {},
      +              "properties": {
      +                "id": {
      +                  "type": "string"
      +                },
      +                "kind": {
      +                  "type": "string"
      +                }
      +              },
      +              "required": [
      +                "kind",
      +                "id"
      +              ],
      +              "type": "object"
      +            },
      +            {
      +              "type": "null"
      +            }
      +          ]
      +        },
      +        "verdict": {
      +          "enum": [
      +            "clear",
      +            "caution",
      +            "flagged",
      +            "confirmed_malicious",
      +            "insufficient"
      +          ],
      +          "type": "string"
      +        },
      +        "verified_owners": {
      +          "type": "number"
      +        },
      +        "version": {
      +          "type": [
      +            "string",
      +            "null"
      +          ]
      +        }
      +      },
      +      "required": [
      +        "summary",
      +        "known",
      +        "distinct_owners",
      +        "verified_owners",
      +        "outcome_breakdown",
      +        "security_status",
      +        "verdict",
      +        "reports_for_this_version",
      +        "be_first",
      +        "contribute",
      +        "corroborated_reports",
      +        "share"
      +      ],
      +      "type": "object"
      +    },
      +    {
      +      "additionalProperties": {},
      +      "properties": {
      +        "data_kind": {
      +          "const": "input_needed",
      +          "type": "string"
      +        },
      +        "detail": {
      +          "type": [
      +            "string",
      +            "null"
      +          ]
      +        },
      +        "error": {
      +          "type": "string"
      +        },
      +        "examples": {
      +          "items": {
      +            "additionalProperties": {},
      +            "propertyNames": {
      +              "type": "string"
      +            },
      +            "type": "object"
      +          },
      +          "type": "array"
      +        },
      +        "needed": {
      +          "type": "string"
      +        },
      +        "tool": {
      +          "type": "string"
      +        }
      +      },
      +      "required": [
      +        "error",
      +        "data_kind",
      +        "tool",
      +        "needed",
      +        "detail",
      +        "examples"
      +      ],
      +      "type": "object"
      +    },
      +    {
      +      "additionalProperties": {},
      +      "properties": {
      +        "error": {
      +          "const": "rate_limited",
      +          "type": "string"
      +        },
      +        "retry_after_s": {
      +          "type": "number"
      +        }
      +      },
      +      "required": [
      +        "error",
      +        "retry_after_s"
      +      ],
      +      "type": "object"
      +    }
      +  ],
      +  "type": "object"
      +}
  4. Changed1 schema field changed
    • changedInput schema / properties / id / description
      Previous value: -"Tool id, e.g. npm:@scope/name or github.com/owner/repo/path"New value: +"Tool id, e.g. npm:@scope/name, pypi:name or github.com/owner/repo/path; a version may be inline (npm:name@1.2.3, pypi:name==1.2.3)"
  5. Changed1 schema field changed
    • addedInput schema / properties / version
      Added value: +{
      +  "description": "The exact version in use, e.g. 1.4.2, to match published advisories",
      +  "maxLength": 128,
      +  "type": "string"
      +}
  6. First observed

TDQS

A4.2/5.0
Behavior4/5

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

Annotations already declare readOnly=true, idempotent=true, non-destructive and open-world, so the safety profile is covered. The description adds what actually comes back (field reports on that version, OSV advisories, security status, page link), which is real behavioral context beyond the annotations, though it says nothing about rate limits, auth, or behavior when the tool is unknown to the registry.

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

Conciseness5/5

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

Three sentences: trigger condition first, then the identifying inputs, then the return contents and the sibling pointer. Nothing is redundant with the schema, and the telegraphic 'File text: forge_scan.' earns its brevity by routing the agent.

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

Completeness5/5

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

With annotations covering safety, full schema coverage, and an output schema handling return shapes, the description only needs to supply the trigger, the identifier choice and the sibling routing, all of which it does. No information needed to invoke this correctly is missing.

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

Parameters4/5

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

Schema coverage is 100%, so baseline would be 3, but the description contributes the important one-of semantic ('Give one of id, url or fingerprint, plus version if known') that the schema's zero required fields does not make explicit. It also constrains the id formats, clarifying selection between id and url.

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 names a concrete resource class (skill, MCP server, plugin, package or API) and the exact question answered (agent-reported problems or an advisory covering that version), so an agent can tell this is a pre-use vetting lookup. It distinguishes itself from forge_scan by handing text filing to that sibling, though it does not distinguish itself from forge_exposure, forge_traps or forge_watch.

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?

The trigger is stated as a precise condition: a task is about to rely on a dependency and you need to know about prior problems or advisories. It names forge_scan as the alternative for filing a report, but gives no exclusions relative to the other three siblings or any note on when a check is unnecessary.

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

Try in Browser

Glama MCP Gateway

Add one secure layer between your agents and this server.