APapicurio
WellKnown

Get MCP tool compatibility

Changed on

Compares the outputSchema of the source tool with the inputSchema of each candidate MCP tool, as if the whole output object were passed to the candidate, and returns every verdict with its reasons and limitations, newest candidate first. A source tool whose outputSchema is absent or cannot be compared is compared with no candidate, and the top-level limitations say why.

get/well-known/mcp-tools/{groupId}/{artifactId}/compatibility

Request

  • The document declares no server URL.
  • Auth
    none declared

Query parameters

versionstring

The version of the source tool. Defaults to the latest version.

verdictstring[]

Returns only the results with this verdict: COMPATIBLE, INCOMPATIBLE or INDETERMINATE. Repeat the parameter to select several verdicts. All three are returned by default. Any other value is rejected with a 400 error.

offsetinteger

The number of results to skip. A negative value is treated as 0.

limitinteger

The maximum number of results to return. A value above 1000 is treated as 1000, and a negative value as 1.

Response

The verdict for each evaluated candidate tool, with its reasons and limitations.

candidateTotalinteger required

The number of MCP tools in the registry, including the source tool. When per-resource authorization is enabled, only the tools that the caller can read are counted. It is 0 when the source tool cannot be compared.

evaluatedinteger required

The number of candidate tools compared with the source tool. The source tool is not a candidate, and a tool that is deleted during the scan, or that has no enabled or deprecated version, is skipped.

scanLimitinteger required

The maximum number of MCP tools scanned, newest first by creation date.

completeboolean required

False when older MCP tools were not compared because only the newest scanLimit tools are scanned. It reports scan coverage, not that every verdict is conclusive.

countinteger required

The number of results that match the verdict filter, before pagination.

Changes