SHshipsecai
mcp

Start MCP tool discovery

Changed on

Initiates an asynchronous discovery workflow for an MCP server. Returns 202 ACCEPTED with a workflow ID for tracking progress.

post/api/v1/mcp/discover

Request

  • Base URL
    /api/v1 (relative, and the document was published on a file host, not at the API’s origin)
  • URL
    /api/v1/api/v1/mcp/discover
  • Auth
    none declared

Request body

transport'http' | 'stdio' required

Transport type for MCP server

namestring required

Human-readable name for the MCP server

endpointstring uri

HTTP endpoint for HTTP transport

headersobject

HTTP headers for authentication

commandstring

Command to run for stdio transport

argsstring[]

Arguments for stdio command

imagestring

Docker image for stdio transport

cacheTokenstring uuid

Cache token for storing/retrieving discovery results

Response

Discovery workflow started successfully

workflowIdstring uuid required

Unique ID for tracking the discovery workflow

cacheTokenstring uuid

Cache token for retrieving cached discovery results

status'started' required

Status indicating workflow has started

Changes