kubefwd MCP Server: Setup for Claude, Cursor and Other Apps

• Lists namespaces you could forward

  Shows the Kubernetes namespaces in your cluster and whether each is already being forwarded.

  Try: “Which namespaces can I forward?”

  Network · list_k8s_namespaces

• Lists a namespace's services

  Shows the services in one namespace with their type, ports and whether they are forwarded.

  Try: “What services are in the dev namespace?”

  Network · list_k8s_services

• Forwards one service to your computer

  Starts forwarding a single service. It returns the local IP, the hostnames added to /etc/hosts and the mapped ports.

  Try: “Forward the postgres service in staging.”

  Write · add_service

• Forwards every service in a namespace

  Starts forwarding all services in a namespace, adds a hosts entry for each and returns how to connect.

  Try: “Forward everything in the dev namespace.”

  Write · add_namespace

• Gives connection details for a forwarded service

  Returns the IP, hostnames, ports and environment variables for a service you forwarded, ready to paste into your setup.

  Try: “What is the connection string for postgres?”

  Network · get_connection_info

• Lists everything being forwarded

  Shows each forwarded service with its namespace, context, forward count and any error.

  Try: “What am I forwarding right now?”

  Network · list_services

• Shows one forwarded service in detail

  Returns its port forwards, pods, hostnames, traffic and error state.

  Try: “Show me the details for the api service.”

  Network · get_service

• Searches your forwarded services

  Finds forwarded services by name pattern, port or namespace.

  Try: “Which forwarded service uses port 5432?”

  Network · find_services

• Lists the hosts entries kubefwd added

  Shows the hostname-to-IP entries that kubefwd wrote to /etc/hosts.

  Try: “What hostnames did kubefwd add?”

  Read · list_hostnames

• Stops forwarding a service

  Ends a service forward, removes its hosts entries and frees its local IP.

  Try: “Stop forwarding postgres.”

  Write · remove_service

• Stops forwarding a whole namespace

  Ends all forwards in a namespace and cleans up its hosts entries and network aliases.

  Try: “Stop forwarding the dev namespace.”

  Write · remove_namespace

• Lists your Kubernetes clusters

  Shows the clusters (contexts) in your kubeconfig.

  Try: “Which clusters can I use?”

  Read · list_contexts

• Lists pods with their status

  Shows pods in a namespace with status, readiness, restarts and age, filtered by label or service if you like.

  Try: “Which pods back the payments service?”

  Network · list_pods

• Shows one pod in detail

  Returns a pod's containers, status, conditions, resources and events.

  Try: “Why is the payments pod not ready?”

  Network · get_pod

• Reads a pod's recent logs

  Returns recent log lines from a pod's container.

  Try: “Show the last logs from the payments pod.”

  Network · get_pod_logs

• Shows Kubernetes events

  Returns scheduling, pulling, starting and killing events, filtered by resource kind and name.

  Try: “Why did my pod fail to start?”

  Network · get_events

• Shows which pods back a service

  Lists a service's endpoints and whether each pod is ready, to debug routing.

  Try: “Does the api service have any ready pods?”

  Network · get_endpoints

• Quick health check of kubefwd

  Returns ok, issues or error with a short message. Meant as a first check before acting.

  Try: “Is kubefwd healthy?”

  Read · get_quick_status

• Reports kubefwd's health and uptime

  Returns healthy, degraded or unhealthy, with the version, uptime and counts of services and errors.

  Try: “How is kubefwd doing?”

  Read · get_health

• Analyzes issues and suggests fixes

  Classifies current problems by priority and names the actions that fix them. The docs call it the best place to start troubleshooting.

  Try: “What is wrong with my forwards?”

  Read · get_analysis

• Explains why forwards are failing

  Gives the error types, affected pods and suggested fixes for the current errors.

  Try: “Why is the redis forward failing?”

  Read · diagnose_errors

• Shows bandwidth use

  Returns bytes in and out, transfer rates and a breakdown per service.

  Try: “Which service uses the most bandwidth?”

  Read · get_metrics

• Shows HTTP requests through the forwards

  Lists requests passing through forwarded services, with method, path, status and response time.

  Try: “Show the last requests to the payments API.”

  Read · get_http_traffic

• Reads kubefwd's own log

  Returns kubefwd log entries, filtered by level or search text.

  Try: “Show recent error messages from kubefwd.”

  Read · get_logs

• Shows the history of events and errors

  Returns events, errors and reconnections over time.

  Try: “What happened to the forwards in the last hour?”

  Read · get_history

• Reconnects an errored service

  Forces an immediate new attempt to connect one service to its pods.

  Try: “Reconnect the api service.”

  Write · reconnect_service

• Reconnects all errored services

  Triggers a reconnect for every service that is in an error state and returns how many.

  Try: “Reconnect everything that failed.”

  Write · reconnect_all_errors

• Re-discovers a service's pods

  Looks for pod changes and updates the forwards, for example after a deployment or pod restart.

  Try: “Re-sync the api service after the deploy.”

  Write · sync_service

Watch out for

• kubefwd runs with sudo and edits your hosts file

  The forwarding process needs elevated rights to change /etc/hosts and add network aliases. The MCP part does not, so keep sudo for kubefwd only. kubefwd.com

• Forwards open cluster services on your machine

  Anything the assistant forwards, such as a database, becomes reachable from your computer. Ask it to remove forwards when you are done. kubefwd.com

• Pod logs and events can contain sensitive data

  The log and event tools return what your cluster writes. Review them before sharing the chat. github.com

• ChatGPT needs a public tunnel

  ChatGPT cannot reach localhost, so the docs suggest exposing the API through a tunnel. They advise doing this only in development. kubefwd.com

Security advisories