DevRev MCP Server

Instructions

Implementation Reference

• src/devrev_mcp/server.py:1140-1261 (handler)

  Handler function for the 'valid_stage_transition' tool. Fetches the current stage of the given work item or part, retrieves the relevant schema and stage diagram, and returns the valid stage transitions from the current stage.

  elif name == "valid_stage_transition":
      if not arguments:
          raise ValueError("Missing arguments")
  
      payload = {}
  
      id = arguments.get("id")
      if not id:
          raise ValueError("Missing id parameter")
      payload["id"] = id
  
      type = arguments.get("type")
      if not type:
          raise ValueError("Missing type parameter")
      payload["type"] = type
  
      current_stage_id = None
      leaf_type = None
      subtype = None
  
      if(type == "issue" or type == "ticket"):
          response = make_devrev_request(
              "works.get",
              {
                  "id": id
              }
          )
  
          if response.status_code != 200:
              error_text = response.text
              return [
                  types.TextContent(
                      type="text",
                      text=f"Get work item failed with status {response.status_code}: {error_text}"
                  )
              ]
          
          current_stage_id = response.json().get("work", {}).get("stage", {}).get("stage", {}).get("id", {})
          leaf_type = response.json().get("work", {}).get("type", {})
          subtype = response.json().get("work", {}).get("subtype", {})
  
      elif(type == "enhancement"):
          response = make_devrev_request(
              "parts.get",
              {
                  "id": id
              }
          )
  
          if response.status_code != 200:
              error_text = response.text
              return [
                  types.TextContent(
                      type="text",
                      text=f"Get part failed with status {response.status_code}: {error_text}"
                  )
              ]
  
          current_stage_id = response.json().get("part", {}).get("stage_v2", {}).get("stage", {}).get("id", {})
          leaf_type = response.json().get("part", {}).get("type", {})
          subtype = response.json().get("part", {}).get("subtype", {})
      else:
          raise ValueError("Invalid type parameter")
      
      if(current_stage_id == {} or leaf_type == {}):
          raise ValueError("Could not get current stage or leaf type")
      
      schema_payload = {}
      if(leaf_type != {}):
          schema_payload["leaf_type"] = leaf_type
      if(subtype != {}):
          schema_payload["custom_schema_spec"] = {"subtype": subtype}
      
      schema_response = make_devrev_request(
          "schemas.aggregated.get",
          schema_payload
      )
  
      if schema_response.status_code != 200:
          error_text = schema_response.text
          return [
              types.TextContent(
                  type="text",
                  text=f"Get schema failed with status {schema_response.status_code}: {error_text}"
              )
          ]
      
      stage_diagram_id = schema_response.json().get("schema", {}).get("stage_diagram_id", {}).get("id", {})
      if stage_diagram_id == None:
          raise ValueError("Could not get stage diagram id")
      
      stage_transitions_response = make_devrev_request(
          "stage-diagrams.get",
          {"id": stage_diagram_id}
      )
  
      if stage_transitions_response.status_code != 200:
          error_text = stage_transitions_response.text
          return [
              types.TextContent(
                  type="text",
                  text=f"Get stage diagram for Get stage transitions failed with status {stage_transitions_response.status_code}: {error_text}"
              )
          ]
  
      stages = stage_transitions_response.json().get("stage_diagram", {}).get("stages", [])
      for stage in stages:
          if stage.get("stage", {}).get("id") == current_stage_id:
              transitions = stage.get("transitions", [])
              return [
                  types.TextContent(
                      type="text",
                      text=f"Valid Transitions for '{id}' from current stage:\n{transitions}"
                  )
              ]
  
      return [
          types.TextContent(
              type="text",
              text=f"No valid transitions found for '{id}' from current stage"
          ),
      ]

• src/devrev_mcp/server.py:421-432 (registration)

  Registration of the 'valid_stage_transition' tool in the list_tools handler, including its name, description, and input schema.

  types.Tool(
      name="valid_stage_transition",
      description="gets a list of valid stage transition for a given work item (issue, ticket) or part (enhancement). Use this before updating stage of the work item or part to ensure the transition is valid.",
      inputSchema={
          "type": "object",
          "properties": {
              "type": {"type": "string", "enum": ["issue", "ticket", "enhancement"]},
              "id": {"type": "string", "description": "The DevRev ID of the work item (issue, ticket) or part (enhancement)"},
          },
          "required": ["type", "id"]
      }
  ),

• src/devrev_mcp/server.py:424-431 (schema)

  Input schema definition for the 'valid_stage_transition' tool, specifying required parameters: type (issue, ticket, enhancement) and id.

  inputSchema={
      "type": "object",
      "properties": {
          "type": {"type": "string", "enum": ["issue", "ticket", "enhancement"]},
          "id": {"type": "string", "description": "The DevRev ID of the work item (issue, ticket) or part (enhancement)"},
      },
      "required": ["type", "id"]
  }