---
title: "Stream external MCP connection requirements checks"
method: POST
path: "/v1/mcp-connections/discover/stream"
tags: ["Authentication"]
---

# Stream external MCP connection requirements checks

`POST /v1/mcp-connections/discover/stream`

## Request

- Base URL: `https://api.openworklabs.com`
- URL: `https://api.openworklabs.com/v1/mcp-connections/discover/stream`
- Auth: one of:
  - API key in header `x-api-key`
  - HTTP bearer

Side-effect-free discovery with ordered SSE check events (aggregate server, resource and provider phases), followed by a result event containing the same requirements as /discover, or a safe error event. No client registration, credential writes or extra probes. Disconnecting cancels discovery.

## Request body

- ExternalMcpRequirementsDiscoveryInput
  - `url` string, uri, required
  - `requestHeaders` object[]: Sent only to the MCP server URL itself during discovery, never to sign-in or metadata addresses. Not stored.
    - `name` string, required
    - `value` string, required

## Response `200`

SSE check events contain JSON {id: server|resource|provider, status: running|passed|failed|skipped, httpStatus?: number, code?: authentication_required|not_required|issuer_mismatch|unavailable|unsupported}. A result event contains McpRequirementsDiscovery; an error event contains {message: 'The server check could not finish. Try again.'}.

## Other responses

- `400`: Invalid request.
- `401`: The caller must be signed in.

## Changes

> 237 revisions in range; 2 not diffed.

- **2026-10-30** `a77c5a5943bf`: 1 info
  - removed the non-success response with the status `404`
- **2026-10-29** `4219d090f166`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/openworklabs/apis/den-api/changes/v1/mcp-connections/discover/stream/post.md)

---

[API](https://skmtc.dev/openworklabs/apis/den-api.md) - [All operations](https://skmtc.dev/openworklabs/apis/den-api/llms.txt) - [OpenAPI document](https://skmtc.dev/openworklabs/apis/den-api/revisions/d4c429e1b555?raw)
