Test MCP Server connection

Test connectivity to the MCP server via its integration URL.

POST /mcp-servers/{mcpServerId}/test

Test MCP Server Connection

cURL

curl --request POST \
  --url https://api.portkey.ai/v1/mcp-servers/{mcpServerId}/test \
  --header 'x-portkey-api-key: <api-key>'

200

{
  "success": true,
  "status_code": 123,
  "response_time_ms": 123,
  "url": "<string>",
  "server_name": "<string>",
  "error": "<string>"
}

Authorizations

x-portkey-api-key · string · header · required

Path Parameters

mcpServerId · string · required

MCP Server ID (UUID) or slug

Response

200 - application/json

OK

success · boolean

status_code · integer | null

HTTP status from upstream (when success)

response_time_ms · integer | null

url · string<uri> | null

server_name · string

error · string | null

Error message when success is false