Discover MCP tools

curl -X POST https://api.synthflow.ai/v2/workspaces/1727192238961x413997613917405200/mcp-tools/discover \
     -H "Authorization: Bearer <token>" \
     -H "Content-Type: application/json" \
     -d '{}'

{
  "servers": [
    {
      "server_name": "mcp-prod-server-01",
      "namespace": "mcp_prod",
      "tools": [
        {
          "namespaced_tool": "mcp_prod__create_issue",
          "original_tool_name": "create_issue",
          "tool_description": "Creates a new issue in the project management system",
          "input_schema": {
            "type": "object",
            "properties": {
              "title": {
                "type": "string",
                "description": "Title of the issue"
              },
              "description": {
                "type": "string",
                "description": "Detailed description of the issue"
              },
              "priority": {
                "type": "string",
                "enum": [
                  "low",
                  "medium",
                  "high"
                ],
                "description": "Priority level of the issue"
              }
            },
            "required": [
              "title"
            ]
          }
        }
      ],
      "config_id": "vault-config-9f8b7c6d",
      "server_title": "MCP Production Server",
      "server_version": "v3.4.2",
      "error": ""
    }
  ]
}

Discovers available MCP tools across all servers configured for the workspace.

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Path parameters

workspace_idstringRequired

Query parameters

config_idstringOptional

Optional MCP config identifier to scope discovery to a single server configuration.

Response

Discovery results (may include per-server errors)

serverslist of objects

Errors

400

Bad Request Error

404

Not Found Error

500

Internal Server Error