---
title: "Get"
method: GET
path: "/mcp-server/instance/{instanceId}"
tags: ["mcp-server"]
---

# Get

`GET /mcp-server/instance/{instanceId}`

Checks the details of a specific server connection instance using its unique ID and API key,
returning server details like authentication status and associated server/platform info.

## Path parameters

- `instanceId` string, uuid, required — The ID of the connection integration instance whose status is being checked. This is returned by the Create API.

## Response `200`

Successful Response

- GetInstanceResponse
  - `instanceId` string, nullable — The unique identifier of the connection integration instance.
  - `authNeeded` boolean — Indicates whether authentication is required for this server instance.
  - `isAuthenticated` boolean — Indicates whether the instance is authenticated successfully.
  - `serverName` string — The name of the MCP server associated with the instance.
  - `platform` string — The platform associated with the instance.
  - `externalUserId` string — The user's identifier on the external platform.
  - `oauthUrl` string, nullable — The OAuth URL for authentication if available, supports white label if configured.

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/klavis-ai/apis/klavis-ai-https-www-klavis-ai.md) · [All operations](https://skmtc.net/klavis-ai/apis/klavis-ai-https-www-klavis-ai/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/klavis-ai/klavis-ai-https-www-klavis-ai/versions/1f05ced7280f/schema)