Hex API MCP Server

Instructions

Args:
    project_id: The UUID of the Hex project
    limit: The number of runs to return
    offset: The number of runs to skip

Returns:
    JSON string with project runs

Implementation Reference

• src/hex_mcp/server.py:190-207 (handler)

  The handler function for the 'get_hex_project_runs' tool. It is registered via the @mcp.tool() decorator and fetches the list of runs for a given Hex project using the Hex API.

  @mcp.tool()
  async def get_hex_project_runs(project_id: str, limit: int = 25, offset: int = 0) -> str:
      """Get the runs for a specific project.
  
      Args:
          project_id: The UUID of the Hex project
          limit: The number of runs to return
          offset: The number of runs to skip
  
      Returns:
          JSON string with project runs
      """
  
      params = {"limit": limit, "offset": offset}
  
      runs = await hex_request("GET", f"/projects/{project_id}/runs", params=params)
      return runs