Kubernetes Tools MCP Server

Instructions

Get events for a specific Kubernetes pod. This is equivalent to the kubectl command:
`kubectl get events -n NAMESPACE --field-selector involvedObject.name=POD_NAME,involvedObject.kind=Pod`

Parameters
----------
pod_name : str
    Name of the pod to retrieve events for.
namespace : str, optional
    Namespace of the pod (default is "default").

Returns
-------
list of EventSummary
    List of events associated with the specified pod. Each EventSummary has the following fields:

    last_seen : Optional[datetime.datetime]
        Timestamp of the last occurrence of the event (if available).
    type : str
        Type of the event.
    reason : str
        Reason for the event.
    object : str
        The object this event applies to.
    message : str
        Message describing the event.
Raises
------
K8sConfigError
    If unable to initialize the K8S API.
K8sApiError
    If the API call to list events fails.

Implementation Reference

• src/k8stools/k8s_tools.py:441-448 (schema)

  Pydantic model defining the output structure for events returned by get_pod_events.

  class EventSummary(BaseModel):
      """This is the representation of a Kubernetes Event"""
      last_seen: Optional[datetime.timedelta]  # Time since event occurred
      type: str
      reason: str
      object: str
      message: str

• src/k8stools/k8s_tools.py:450-500 (handler)

  Core handler function that fetches pod events from Kubernetes API using field selector and maps to EventSummary objects.

  def get_pod_events(pod_name: str, namespace: str = "default") -> list[EventSummary]:
      """
      Get events for a specific Kubernetes pod. This is equivalent to the kubectl command:
      `kubectl get events -n NAMESPACE --field-selector involvedObject.name=POD_NAME,involvedObject.kind=Pod`
  
      Parameters
      ----------
      pod_name : str
          Name of the pod to retrieve events for.
      namespace : str, optional
          Namespace of the pod (default is "default").
  
      Returns
      -------
      list of EventSummary
          List of events associated with the specified pod. Each EventSummary has the following fields:
  
          last_seen : Optional[datetime.datetime]
              Timestamp of the last occurrence of the event (if available).
          type : str
              Type of the event.
          reason : str
              Reason for the event.
          object : str
              The object this event applies to.
          message : str
              Message describing the event.
      Raises
      ------
      K8sConfigError
          If unable to initialize the K8S API.
      K8sApiError
          If the API call to list events fails.
      """
      global K8S
      if K8S is None:
          K8S = _get_api_client()
      logging.info(f"get_pod_events(pod_name={pod_name}, namespace={namespace})")
      field_selector = f"involvedObject.name={pod_name}"
      events = K8S.list_namespaced_event(namespace, field_selector=field_selector)
      now = datetime.datetime.now(datetime.timezone.utc)
      return [
          EventSummary(
              last_seen=(now - event.last_timestamp) if event.last_timestamp else None,
              type=event.type,
              reason=event.reason,
              object=getattr(event.involved_object, 'name', pod_name),
              message=event.message,
          )
          for event in events.items
      ]

• src/k8stools/k8s_tools.py:1101-1111 (registration)

  Registration of get_pod_events in the TOOLS list for MCP integration.

  TOOLS = [
      get_namespaces,
      get_node_summaries,
      get_pod_summaries,
      get_pod_container_statuses,
      get_pod_events,
      get_pod_spec,
      get_logs_for_pod_and_container,
      get_deployment_summaries,
      get_service_summaries
  ]