SSO MCP Server

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "title": "Process Query MCP Tools",
  "description": "MCP tool definitions for the Process Query feature (003-process-query)",
  "version": "1.0.0",
  "tools": [
    {
      "name": "get_process",
      "description": "Retrieve a specific development process by name. Returns the complete process documentation including name, description, and full markdown content.",
      "inputSchema": {
        "type": "object",
        "properties": {
          "name": {
            "type": "string",
            "description": "Name of the process to retrieve (case-insensitive). Examples: 'code-review', 'deployment', 'incident-response'",
            "minLength": 1
          }
        },
        "required": ["name"],
        "additionalProperties": false
      },
      "outputSchema": {
        "oneOf": [
          {
            "type": "object",
            "description": "Success response with process content",
            "properties": {
              "name": {
                "type": "string",
                "description": "Process name"
              },
              "description": {
                "type": "string",
                "description": "Brief process description"
              },
              "content": {
                "type": "string",
                "description": "Full markdown content of the process"
              }
            },
            "required": ["name", "content"]
          },
          {
            "type": "object",
            "description": "Error response when process not found",
            "properties": {
              "error": {
                "type": "string",
                "enum": ["PROCESS_NOT_FOUND"]
              },
              "message": {
                "type": "string",
                "description": "Error message"
              },
              "available": {
                "type": "array",
                "items": {"type": "string"},
                "description": "List of available process names"
              }
            },
            "required": ["error", "message", "available"]
          }
        ]
      },
      "requiresAuth": true
    },
    {
      "name": "list_processes",
      "description": "List all available development processes with their names and descriptions. Does not return full content.",
      "inputSchema": {
        "type": "object",
        "properties": {},
        "additionalProperties": false
      },
      "outputSchema": {
        "type": "object",
        "properties": {
          "processes": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "name": {
                  "type": "string",
                  "description": "Process name"
                },
                "description": {
                  "type": "string",
                  "description": "Brief process description"
                }
              },
              "required": ["name"]
            },
            "description": "Array of process metadata"
          },
          "count": {
            "type": "integer",
            "description": "Number of processes found",
            "minimum": 0
          },
          "message": {
            "type": "string",
            "description": "Optional message (e.g., when directory is empty)"
          }
        },
        "required": ["processes", "count"]
      },
      "requiresAuth": true
    },
    {
      "name": "search_processes",
      "description": "Search across all development processes for a keyword. Returns matching processes ranked by relevance (title matches rank higher than content matches). Maximum 50 results.",
      "inputSchema": {
        "type": "object",
        "properties": {
          "query": {
            "type": "string",
            "description": "Keyword or phrase to search for (case-insensitive). Searches across process name, description, and content.",
            "minLength": 1
          }
        },
        "required": ["query"],
        "additionalProperties": false
      },
      "outputSchema": {
        "type": "object",
        "properties": {
          "results": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "name": {
                  "type": "string",
                  "description": "Process name"
                },
                "description": {
                  "type": "string",
                  "description": "Brief process description"
                },
                "relevance_score": {
                  "type": "number",
                  "description": "Relevance score (0.0 to 1.0)",
                  "minimum": 0,
                  "maximum": 1
                },
                "snippet": {
                  "type": "string",
                  "description": "Content excerpt showing match context"
                }
              },
              "required": ["name", "relevance_score"]
            },
            "maxItems": 50,
            "description": "Array of search results, sorted by relevance"
          },
          "query": {
            "type": "string",
            "description": "The search query that was executed"
          },
          "count": {
            "type": "integer",
            "description": "Number of results returned",
            "minimum": 0,
            "maximum": 50
          },
          "total_processes": {
            "type": "integer",
            "description": "Total number of processes searched",
            "minimum": 0
          },
          "message": {
            "type": "string",
            "description": "Optional message (e.g., when no matches found)"
          }
        },
        "required": ["results", "query", "count", "total_processes"]
      },
      "requiresAuth": true
    }
  ],
  "authentication": {
    "description": "All tools require authentication using the existing mechanism (LOCAL, CLOUD, or AUTO mode)",
    "modes": ["LOCAL", "CLOUD", "AUTO"],
    "errorResponse": {
      "type": "object",
      "properties": {
        "error": {
          "type": "string",
          "enum": ["AUTHENTICATION_REQUIRED", "AUTHENTICATION_FAILED"]
        },
        "message": {
          "type": "string"
        }
      }
    }
  }
}