Threat.Zone MCP Server

Instructions

Implementation Reference

• src/threatzone_mcp/server.py:137-155 (handler)

  The main handler function for the 'interpret_status' tool. It takes a numeric status value and returns a human-readable string description using a predefined mapping. Registered via @app.tool decorator.

  @app.tool
  async def interpret_status(status_value: int) -> str:
      """
      Interpret a numeric status value from submission results.
      
      Args:
          status_value: Numeric status value (1-5)
          
      Returns:
          Human-readable status description
      """
      status_map = {
          1: "File received",
          2: "Submission is failed", 
          3: "Submission is running",
          4: "Submission VM is ready",
          5: "Submission is finished"
      }
      return status_map.get(status_value, f"Unknown status: {status_value}")

• src/threatzone_mcp/server.py:137-137 (registration)

  The @app.tool decorator registers the interpret_status function as an MCP tool.

  @app.tool