DevRev MCP Server

Instructions

Implementation Reference

• src/devrev_mcp/server.py:916-975 (handler)

  Handler for the 'update_part' tool: validates arguments, builds payload for parts.update API, calls make_devrev_request, and returns success/error message.
  elif name == "update_part": 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 part_name = arguments.get("name") if part_name: payload["name"] = part_name owned_by = arguments.get("owned_by") if owned_by: payload["owned_by"] = owned_by description = arguments.get("description") if description: payload["description"] = description target_close_date = arguments.get("target_close_date") if target_close_date: payload["target_close_date"] = target_close_date target_start_date = arguments.get("target_start_date") if target_start_date: payload["target_start_date"] = target_start_date stage = arguments.get("stage") if stage: payload["stage_v2"] = stage response = make_devrev_request( "parts.update", payload ) if response.status_code != 200: error_text = response.text return [ types.TextContent( type="text", text=f"Update part failed with status {response.status_code}: {error_text}" ) ] return [ types.TextContent( type="text", text=f"Part updated successfully: {id}" ) ]
• src/devrev_mcp/server.py:254-271 (registration)

  Registration of the 'update_part' tool in the list_tools handler, including name, description, and input schema.
  types.Tool( name="update_part", description="Update an existing part (enhancement) in DevRev", inputSchema={ "type": "object", "properties": { "type": {"type": "string", "enum": ["enhancement"]}, "id": {"type": "string", "description": "The DevRev ID of the part"}, "name": {"type": "string", "description": "The name of the part"}, "owned_by": {"type": "array", "items": {"type": "string"}, "description": "The DevRev IDs of the users assigned to the part"}, "description": {"type": "string", "description": "The description of the part"}, "target_close_date": {"type": "string", "description": "The target closed date of the part, for example: 2025-06-03T00:00:00Z"}, "target_start_date": {"type": "string", "description": "The target start date of the part, for example: 2025-06-03T00:00:00Z"}, "stage": {"type": "string", "description": "The stage DevRev ID of the part. Use valid_stage_transition tool to get the list of valid stages you an update to."}, }, "required": ["id", "type"], }, ),
• src/devrev_mcp/server.py:257-270 (schema)

  Input schema/JSON Schema for the 'update_part' tool parameters.
  inputSchema={ "type": "object", "properties": { "type": {"type": "string", "enum": ["enhancement"]}, "id": {"type": "string", "description": "The DevRev ID of the part"}, "name": {"type": "string", "description": "The name of the part"}, "owned_by": {"type": "array", "items": {"type": "string"}, "description": "The DevRev IDs of the users assigned to the part"}, "description": {"type": "string", "description": "The description of the part"}, "target_close_date": {"type": "string", "description": "The target closed date of the part, for example: 2025-06-03T00:00:00Z"}, "target_start_date": {"type": "string", "description": "The target start date of the part, for example: 2025-06-03T00:00:00Z"}, "stage": {"type": "string", "description": "The stage DevRev ID of the part. Use valid_stage_transition tool to get the list of valid stages you an update to."}, }, "required": ["id", "type"], },
• src/devrev_mcp/utils.py:12-39 (helper)

  Helper utility make_devrev_request used by update_part handler to POST payload to DevRev API endpoint 'parts.update'.
  def make_devrev_request(endpoint: str, payload: Dict[str, Any]) -> requests.Response: """ Make an authenticated request to the DevRev API. Args: endpoint: The API endpoint path (e.g., "works.get" or "search.hybrid") payload: The JSON payload to send Returns: requests.Response object Raises: ValueError: If DEVREV_API_KEY environment variable is not set """ api_key = os.environ.get("DEVREV_API_KEY") if not api_key: raise ValueError("DEVREV_API_KEY environment variable is not set") headers = { "Authorization": f"{api_key}", "Content-Type": "application/json", } return requests.post( f"https://api.devrev.ai/{endpoint}", headers=headers, json=payload )