---
title: "Start MCP group tool discovery"
method: POST
path: "/api/v1/mcp/discover-group"
tags: ["mcp"]
---

# Start MCP group tool discovery

`POST /api/v1/mcp/discover-group`

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

## Request body

- GroupDiscoveryInputDto
  - `image` string — Docker image for stdio transport
  - `servers` object[], required — Servers to discover
    - `name` string, required — Server name
    - `transport` 'http' | 'stdio', required — Transport type for MCP server
    - `endpoint` string, uri — HTTP endpoint for HTTP transport
    - `headers` object — HTTP headers for authentication
    - `command` string — Command to run for stdio transport
    - `args` string[] — Arguments for stdio command

## Response `202`

Group discovery workflow started successfully

- GroupDiscoveryStartResponseDto
  - `workflowId` string, uuid, required — Unique ID for tracking the discovery workflow
  - `cacheTokens` object, required — Map of server name to cache token
  - `status` 'started', required — Status indicating workflow has started

---

[API](https://skmtc.net/shipsecai/apis/shipsec-studio-api.md) · [All operations](https://skmtc.net/shipsecai/apis/shipsec-studio-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/shipsecai/shipsec-studio-api/revisions/cc60562ad9f3/schema)