---
title: "Find compatible MCP tools"
method: GET
path: "/well-known/mcp-tools/{groupId}/{artifactId}/compatible"
tags: ["WellKnown"]
---

# Find compatible MCP tools

`GET /well-known/mcp-tools/{groupId}/{artifactId}/compatible`

## Request

- The document declares no server URL.
- Auth: none declared

Returns the registered MCP tools whose `inputSchema` accepts every output that the `outputSchema` of the source tool permits, newest first. These are the tools that the `compatibility` operation reports as `COMPATIBLE`. The source tool is never returned, and a source tool whose `outputSchema` is absent or cannot be compared returns no tools.

## Query parameters

- `version` string
- `offset` integer
- `limit` integer

## Response `200`

The MCP tools that accept every output of the source tool.

- McpCompatibleToolsResults: The MCP tools whose `inputSchema` accepts every output of the source tool.
  - `count` integer, required: The number of compatible tools, before pagination.
  - `tools` McpToolSearchResult[], required: The requested page of compatible tools, newest first.
    - `groupId` string
    - `artifactId` string
    - `name` string
    - `title` string
    - `description` string
    - `owner` string
    - `createdOn` integer
    - `parameters` string[]

## Other responses

- `401`: Common response for all operations that can return a `401` error indicating authentication is required.
- `403`: Common response for all operations that can return a `403` error indicating the user is authenticated but not authorized.
- `404`: Common response for all operations that can return a `404` error.
- `500`: Common response for all operations that can fail with an unexpected server error.

## Changes

- **2026-11-10** `9ea539691ab7`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/apicurio/apis/apicurio-registry-api-v3/changes/well-known/mcp-tools/:groupId/:artifactId/compatible/get.md)

---

[API](https://skmtc.dev/apicurio/apis/apicurio-registry-api-v3.md) - [All operations](https://skmtc.dev/apicurio/apis/apicurio-registry-api-v3/llms.txt) - [OpenAPI document](https://skmtc.dev/apicurio/apis/apicurio-registry-api-v3/revisions/952cb20d3c0d?raw)