Test MCP server

Test the MCP server connection and list available tools.

POST /api/captain/agents/{id}/mcp/servers/{name}/test

Test MCP server

cURL

curl --request POST \
  --url http://localhost:63372/api/captain/agents/{id}/mcp/servers/{name}/test \
  --cookie captain_session=

200

{
  "ok": true,
  "message": "Connected successfully, 5 tool(s) available",
  "tools": [
    {
      "name": "read_file",
      "description": "Read contents of a file"
    }
  ]
}

Authorizations

cookieAuthbearerAuth

captain_session · string · cookie · required

HMAC-signed session cookie returned by /api/captain/auth/login. Valid for 7 days. Invalidated when password changes.

Path Parameters

id · string · required

Agent ID

name · string · required

MCP server name

Response

200

application/json

Connection test result

ok · boolean · required

message · string · required

Example:

"Connected successfully, 5 tool(s) available"

tools · object[] | null

Show child attributes