---
title: "Probe Endpoint"
method: POST
path: "/gateways/mcps/endpoints/probe"
tags: ["Gateway: MCP"]
---

# Probe Endpoint

`POST /gateways/mcps/endpoints/probe`

Report what a URL is, so the connect journey can ask for a URL first.

Gated on EDIT_MCP_ENDPOINTS rather than VIEW: this makes the deployment fetch an
address of the caller's choosing, so it is the permission to add a server, not the
permission to look at one.

## Request body

- MCPEndpointProbeRequest — Inspect a server URL before an endpoint exists. `url` is the only field, and deliberately: the probe routes a request and reports what came back. It takes no name (nothing is being labelled), no slug or id (nothing is being identified), and no credential — there is no endpoint to carry one, and a credential must never be sent to an origin nobody has chosen yet.
  - `url` string, required

## Response `200`

Successful Response

- MCPEndpointProbeResponse
  - `count` integer
  - `probe` MCPServerProbeResult — Everything the probe learned. No identity, because it created nothing.
    - `reachable` boolean
    - `server_name` string, nullable
    - `protocol_version` string, nullable
    - `auth` MCPProbeAuth
      - `mode` 'none' | 'oauth' | 'unknown' — What the server asked for, as far as the probe could establish.
      - `authorization_server` string, nullable
      - `scopes_offered` string[]
      - `registration` 'dynamic' | 'metadata' | 'unavailable' — How this deployment would register itself with the discovered issuer.
      - `challenge_status` integer, nullable
      - `challenge_schemes` string[]
    - `problem` MCPProbeProblem — Why the probe could not answer. `cause` is for branching, `message` for a person.
      - `cause` string, required
      - `message` string, required
      - `transport` string, nullable

## Other responses

- `422` — Validation Error

## Changes

- **2026-09-20** `7a4b57044657` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/agenta-ai/apis/agenta-api/changes/gateways/mcps/endpoints/probe/post.md)

---

[API](https://skmtc.dev/agenta-ai/apis/agenta-api.md) · [All operations](https://skmtc.dev/agenta-ai/apis/agenta-api/llms.txt) · [OpenAPI document](https://skmtc.dev/agenta-ai/apis/agenta-api/revisions/72f2feba8ccb?raw)