DevRev MCP Server

Instructions

Implementation Reference

• src/devrev_mcp/server.py:976-1060 (handler)

  The handler logic for executing the 'list_parts' tool. It parses arguments, builds a payload for the DevRev API 'parts.list' endpoint, makes the request using make_devrev_request, and returns the results or error.

  elif name == "list_parts":
      if not arguments:
          raise ValueError("Missing arguments")
  
      payload = {}
      payload["enhancement"] = {}
  
      type = arguments.get("type")
      if not type:
          raise ValueError("Missing type parameter")
      payload["type"] = type
      
      cursor = arguments.get("cursor")
      if cursor:
          payload["cursor"] = cursor["next_cursor"]
          payload["mode"] = cursor["mode"]
      
      owned_by = arguments.get("owned_by")
      if owned_by:
          payload["owned_by"] = owned_by
      
      parent_part = arguments.get("parent_part")
      if parent_part:
          payload["parent_part"] = {"parts": parent_part}
      
      created_by = arguments.get("created_by")
      if created_by:
          payload["created_by"] = created_by
      
      modified_by = arguments.get("modified_by")
      if modified_by:
          payload["modified_by"] = modified_by
      
      sort_by = arguments.get("sort_by")
      if sort_by:
          payload["sort_by"] = sort_by
      
      accounts = arguments.get("accounts")
      if accounts:
          if 'enhancement' in type:
              payload["enhancement"]["accounts"] = accounts
      
      target_close_date = arguments.get("target_close_date")
      if target_close_date:
          if 'enhancement' in type:
              payload["enhancement"]["target_close_date"] = {"after": target_close_date["after"], "before": target_close_date["before"]}
      
      target_start_date = arguments.get("target_start_date")
      if target_start_date:
          if 'enhancement' in type:
              payload["enhancement"]["target_start_date"] = {"after": target_start_date["after"], "before": target_start_date["before"]}
  
      actual_close_date = arguments.get("actual_close_date")
      if actual_close_date:
          if 'enhancement' in type:
              payload["enhancement"]["actual_close_date"] = {"after": actual_close_date["after"], "before": actual_close_date["before"]}
      
      actual_start_date = arguments.get("actual_start_date")
      if actual_start_date:
          if 'enhancement' in type:
              payload["enhancement"]["actual_start_date"] = {"after": actual_start_date["after"], "before": actual_start_date["before"]}
  
      if payload["enhancement"] == {}:
          payload.pop("enhancement")
  
      response = make_devrev_request(
          "parts.list",
          payload
      )
      
      if response.status_code != 200:
          error_text = response.text
          return [
              types.TextContent(
                  type="text",
                  text=f"List parts failed with status {response.status_code}: {error_text}"
              )
          ]
      
      return [
          types.TextContent(
              type="text",
              text=f"Parts listed successfully: {response.json()}"
          )
      ]

• src/devrev_mcp/server.py:272-329 (registration)

  The registration of the 'list_parts' tool in the list_tools handler, including its name, description, and detailed input schema for parameters like type, cursor, filters, and date ranges.

  types.Tool(
      name="list_parts",
      description="List all parts (enhancements) in DevRev",
      inputSchema={
          "type": "object",
          "properties": {
              "type": {"type": "string", "enum": ["enhancement"], "description": "The type of parts to list"},
              "cursor": {
                  "type": "object",
                  "properties": {
                      "next_cursor": {"type": "string", "description": "The cursor to use for pagination. If not provided, iteration begins from the first page."},
                      "mode": {"type": "string", "enum": ["after", "before"], "description": "The mode to iterate after the cursor or before the cursor ."},
                  },
                  "required": ["next_cursor", "mode"],
                  "description": "The cursor to use for pagination. If not provided, iteration begins from the first page. In the output you get next_cursor, use it and the correct mode to get the next or previous page. You can use these to loop through all the pages."
              },
              "owned_by": {"type": "array", "items": {"type": "string"}, "description": "The DevRev IDs of the users assigned to the parts to list"},
              "parent_part": {"type": "array", "items": {"type": "string"}, "description": "The DevRev IDs of the parent parts to of the parts to list"},
              "created_by": {"type": "array", "items": {"type": "string"}, "description": "The DevRev IDs of the users who created the parts to list"},
              "modified_by": {"type": "array", "items": {"type": "string"}, "description": "The DevRev IDs of the users who modified the parts to list"},
              "sort_by": {"type": "array", "items": {"type": "string", "enum": ["target_close_date:asc", "target_close_date:desc", "target_start_date:asc", "target_start_date:desc", "actual_close_date:asc", "actual_close_date:desc", "actual_start_date:asc", "actual_start_date:desc", "created_date:asc", "created_date:desc", "modified_date:asc", "modified_date:desc"]}, "description": "The field (and the order) to sort the parts by, in the sequence of the array elements"},
              "accounts": {"type": "array", "items": {"type": "string"}, "description": "The account IDs of the accounts filter on parts to list"},
              "target_close_date": {
                  "type": "object",
                  "properties": {
                      "after": {"type": "string", "description": "The start date of the target close date range, for example: 2025-06-03T00:00:00Z"},
                      "before": {"type": "string", "description": "The end date of the target close date range, for example: 2025-06-03T00:00:00Z"},
                  }, 
                  "required": ["after", "before"]
              },
              "target_start_date": {
                  "type": "object",
                  "properties": {
                      "after": {"type": "string", "description": "The start date of the target start date range, for example: 2025-06-03T00:00:00Z"},
                      "before": {"type": "string", "description": "The end date of the target start date range, for example: 2025-06-03T00:00:00Z"},
                  }, 
                  "required": ["after", "before"]
              },
              "actual_close_date": {
                  "type": "object",
                  "properties": {
                      "after": {"type": "string", "description": "The start date of the actual close date range, for example: 2025-06-03T00:00:00Z"},
                      "before": {"type": "string", "description": "The end date of the actual close date range, for example: 2025-06-03T00:00:00Z"},
                  }, 
                  "required": ["after", "before"]
              },
              "actual_start_date": {
                  "type": "object",
                  "properties": {
                      "after": {"type": "string", "description": "The start date of the actual start date range, for example: 2025-06-03T00:00:00Z"},
                      "before": {"type": "string", "description": "The end date of the actual start date range, for example: 2025-06-03T00:00:00Z"},
                  }, 
                  "required": ["after", "before"]
              },
          },
          "required": ["type"],
      },
  ),

• src/devrev_mcp/utils.py:12-40 (helper)

  Utility function make_devrev_request used by the list_parts handler to send POST requests to DevRev API endpoints with authentication.

  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
      )