DevRev MCP Server

Instructions

Implementation Reference

• src/devrev_mcp/server.py:504-533 (handler)

  Handler function implementing the 'get_vista' tool logic. Extracts 'id' from arguments, calls make_internal_devrev_request to 'vistas.get' endpoint, handles errors, and returns vista details.
  elif name == "get_vista": if not arguments: raise ValueError("Missing arguments") id = arguments.get("id") if not id: raise ValueError("Missing id ") response = make_internal_devrev_request( "vistas.get", { "id": id } ) if response.status_code != 200: error_text = response.text return [ types.TextContent( type="text", text=f"get_vista failed with status {response.status_code}: {error_text}" ) ] return [ types.TextContent( type="text", text=f"Vista details for '{id}':\n{response.json()}" ) ]
• src/devrev_mcp/server.py:33-46 (schema)

  JSON schema definition for the 'get_vista' tool input, requiring a 'id' string property.
  types.Tool( name="get_vista", description="Retrieve information about a vista in DevRev using its ID. In DevRev a vista is a sprint board which contains sprints (or vista group items). The reponse of this tool will contain the sprint (or vista group item) IDs that you can use to filter on sprints.", inputSchema={ "type": "object", "properties": { "id": { "type": "string", "description": "The DevRev ID of the vista" } }, "required": ["id"] }, ),
• src/devrev_mcp/server.py:33-46 (registration)

  Registration of the 'get_vista' tool in the handle_list_tools() function.
  types.Tool( name="get_vista", description="Retrieve information about a vista in DevRev using its ID. In DevRev a vista is a sprint board which contains sprints (or vista group items). The reponse of this tool will contain the sprint (or vista group item) IDs that you can use to filter on sprints.", inputSchema={ "type": "object", "properties": { "id": { "type": "string", "description": "The DevRev ID of the vista" } }, "required": ["id"] }, ),
• src/devrev_mcp/utils.py:41-68 (helper)

  Utility function make_internal_devrev_request used by the get_vista handler to make authenticated POST requests to internal DevRev API endpoints.
  def make_internal_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/internal/{endpoint}", headers=headers, json=payload )