---
title: "POST /api/mcp/probe"
method: POST
path: "/api/mcp/probe"
tags: ["mcp"]
---

# POST /api/mcp/probe

`POST /api/mcp/probe`

## Request body

- object
  - `endpoint` string, required
  - `headers` object, nullable
  - `queryParams` object, nullable

## Response `200`

Success

- object
  - `connected` boolean, required
  - `requiresAuthentication` boolean, required
  - `requiresOAuth` boolean, required
  - `supportsDynamicRegistration` boolean, required
  - `name` string, required
  - `slug` string, required
  - `toolCount` union, required
    - number
    - 'NaN'
    - 'Infinity'
    - '-Infinity'
    - 'Infinity' | '-Infinity' | 'NaN'
  - `serverName` string, nullable, required
  - `instructions` string, nullable, required
  - `versionNegotiation` 'auto' | 'legacy', nullable

## Other responses

- `400` — McpConnectionError | McpToolDiscoveryError
- `500` — InternalError

## Changes

> 8 revisions in range; 4 could not be searched.

- **2026-08-30** `03ae66214fb3` — 3 info
  - added the optional property `anyOf[#/components/schemas/McpToolDiscoveryError]/modernContractViolation` to the response with the `400` status
  - added the optional property `anyOf[#/components/schemas/McpToolDiscoveryError]/reauthorizationRequired` to the response with the `400` status
  - added the optional property `versionNegotiation` to the response with the `200` status

[Change history](https://skmtc.dev/executor/apis/executor-api/changes/api/mcp/probe/post.md)

---

[API](https://skmtc.dev/executor/apis/executor-api.md) · [All operations](https://skmtc.dev/executor/apis/executor-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/executor/executor-api/revisions/03ae66214fb3/schema)