List MCP servers

GET/tools/mcp-server/list

Lists all MCP servers for a specific user

RequiresBearerauthentication

Returns

Successfully listed MCP servers

Response fields

successbooleanoptional

Whether the operation succeeded

messagestringoptional

Status message

dataobjectoptional

Single MCP server (returned by GET /tools/mcp-server/{mcp_server_id}).

idstringoptional

ID of the MCP server

namestringoptional

Name of the MCP server

descriptionstringoptional

Description of the MCP server

mcp_server_urlstringoptional

URL of the MCP server

mcp_serversobject[]optional

List of MCP servers. Returned by /tools/mcp-server/create (the newly created server) and /tools/mcp-server/list (all servers).

idstringoptional

ID of the MCP server

namestringoptional

Name of the MCP server

descriptionstringoptional

Description of the MCP server

mcp_server_urlstringoptional

URL of the MCP server

mcp_server_toolsobject[]optional

Tools loaded from the MCP server. Returned by /tools/mcp-server/create alongside the server record, since tool discovery happens at create time.

idstringoptional

ID of the MCP server tool

namestringoptional

Name of the MCP server tool

descriptionstringoptional

Description of the MCP server tool

input_schemaobjectoptional

Input schema of the MCP server tool

mcp_server_idstringoptional

ID of the MCP server that the tool belongs to

mcp_server_urlstringoptional

URL of the MCP server

GETRequest

# Get authentication token
PHENOML_TOKEN=$(curl -X POST "https://experiment.app.pheno.ml/v2/auth/token" \
  -u "$PHENOML_CLIENT_ID:$PHENOML_CLIENT_SECRET" \
  | jq -r '.access_token')

curl -X GET "https://experiment.app.pheno.ml/tools/mcp-server/list" \
  -H "Authorization: Bearer $PHENOML_TOKEN"

200 OKExample Response

{
  "success": true,
  "message": "MCP Servers retrieved successfully",
  "mcp_servers": [
    {
      "id": "123",
      "name": "My MCP Server",
      "description": "My MCP Server is a server that provides MCP services",
      "mcp_server_url": "https://mcp.example.com"
    },
    {
      "id": "456",
      "name": "Another MCP Server",
      "description": "A second MCP server",
      "mcp_server_url": "https://other.mcp.example.com"
    }
  ]
}