/

List MCP server tools

GET/tools/mcp-server/{mcp_server_id}/list

Lists all MCP server tools for a specific MCP server

RequiresBearerauthentication

Path parameters

mcp_server_idstringrequired

ID of the MCP server to list tools for

Returns

Successfully listed MCP server tools

Response fields

successbooleanoptional

Whether the operation succeeded

messagestringoptional

Status message

dataobjectoptional

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

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

mcp_server_toolsobject[]optional

List of MCP server tools. Returned by /tools/mcp-server/{mcp_server_id}/list.

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/{mcp_server_id}/list" \
  -H "Authorization: Bearer $PHENOML_TOKEN"

200 OKExample Response

{
  "success": true,
  "message": "MCP Server tools retrieved successfully",
  "mcp_server_tools": [
    {
      "id": "tool-001",
      "name": "search_endpoints",
      "description": "Search across the documented endpoints",
      "input_schema": {
        "query": "string"
      },
      "mcp_server_id": "123",
      "mcp_server_url": "https://mcp.example.com"
    },
    {
      "id": "tool-002",
      "name": "get_endpoint",
      "description": "Fetch a single endpoint by ID",
      "input_schema": {
        "endpoint_id": "string"
      },
      "mcp_server_id": "123",
      "mcp_server_url": "https://mcp.example.com"
    }
  ]
}