add_employee

Implementation Reference

• main.py:55-62 (handler)

  The @mcp.tool() decorated function implementing the 'add_employee' tool. It makes a POST request to the /employees endpoint with the provided name and age, returning the API response.

  @mcp.tool()
  async def add_employee(name: str, age: int) -> dict:
      url = f"{URL_BASE}/employees"
      response = await make_request(url, "POST", {
          "name": name,
          "age": age
      })
      return response

• main.py:13-41 (helper)

  Helper function used by the add_employee tool (and others) to make HTTP requests to the backend API with error handling.

  async def make_request(url: str, method: str = "GET", json_data: dict = None) -> dict[str, Any] | None:
      """Make a request to the API with proper error handling for all HTTP methods."""
      headers = {
          "User-Agent": USER_AGENT,
          "Accept": "application/json"
      }
      
      # Add Content-Type header for requests with JSON data
      if json_data is not None:
          headers["Content-Type"] = "application/json"
      
      async with httpx.AsyncClient() as client:
          try:
              if method.upper() == "GET":
                  response = await client.get(url, headers=headers, timeout=30.0)
              elif method.upper() == "POST":
                  response = await client.post(url, headers=headers, json=json_data, timeout=30.0)
              elif method.upper() == "PUT":
                  response = await client.put(url, headers=headers, json=json_data, timeout=30.0)
              elif method.upper() == "DELETE":
                  response = await client.delete(url, headers=headers, timeout=30.0)
              else:
                  raise ValueError(f"Unsupported HTTP method: {method}")
              
              response.raise_for_status()
              return response.json()
          except Exception:
              return None