---
title: "Inspect an MCP server address"
method: POST
path: "/api/v1/org-mcp-servers/inspection"
tags: ["authed"]
---

# Inspect an MCP server address

`POST /api/v1/org-mcp-servers/inspection`

## Request

- Base URL: `https://api.teaflask.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.teaflask.com/api/v1/org-mcp-servers/inspection`
- Auth: none declared

Which sign-in the server at an address asks for, a name for it, and
whether the organization already added it; never the address itself.

## Request body

- object
  - `url` string, password, required: The server's full address, starting with https://.

## Response `200`

Successful Response

- OrgMcpServerInspection
  - `host` string, required: The host name of the address.
  - `sign_in` 'oauth' | 'token' | 'none', required
  - `suggested_name` string, required: A name to offer for the server.
  - `already_added_as` string, nullable, required: The name of the organization's server already at this address, or null.
  - `already_added_id` string, uuid, nullable, required: The id of the organization's server already at this address, or null.

## Other responses

- `401`: Unauthorized
- `403`: Forbidden
- `404`: Not found
- `405`: Method not allowed
- `422`: The request was refused, or the server couldn't be connected
- `429`: Too many dials this minute or day
- `500`: Internal server error

## Changes

- **2026-11-03** `c6ac9fd6657f`: 7 info
  - removed the `STEEP_LEARNING_DISABLED` enum value from the `error/code` response property for the response status `401`
  - removed the `STEEP_LEARNING_DISABLED` enum value from the `error/code` response property for the response status `403`
  - removed the `STEEP_LEARNING_DISABLED` enum value from the `error/code` response property for the response status `404`
  - removed the `STEEP_LEARNING_DISABLED` enum value from the `error/code` response property for the response status `405`
  - …3 more

[Operation history](https://skmtc.dev/teaflask/apis/teaflask-api/changes/api/v1/org-mcp-servers/inspection/post.md)

---

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