---
title: "Get MCP discovery status"
method: GET
path: "/api/v1/mcp/discover/{workflowId}"
tags: ["mcp"]
---

# Get MCP discovery status

`GET /api/v1/mcp/discover/{workflowId}`

Queries the status of an MCP discovery workflow by workflow ID. Returns current status and discovered tools if available.

## Path parameters

- `workflowId` string, required

## Response `200`

Discovery status retrieved successfully

- DiscoveryStatusDto
  - `workflowId` string, uuid, required — Workflow ID
  - `status` 'running' | 'completed' | 'failed', required — Current status of discovery
  - `tools` object[] — Discovered tools (available when completed)
    - `name` string, required — Tool name
    - `description` string — Tool description
    - `inputSchema` object — JSON Schema for tool input
  - `toolCount` integer — Number of tools discovered
  - `error` string — Error message if discovery failed
  - `errorCode` string — Error code for categorizing failures

## Other responses

- `404` — Workflow not found

---

[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)