Kubefwd
Kubernetes port forwarding for local development with automatic /etc/hosts entries.
Connector by txn2 · GitHub account verified by the MCP Registry
Install
Works with Claude Desktop. Read the repository before you give any tool access to your data.
MCP bundle (.mcpb): open it with Claude Desktop.
Get the weekly diff
The weekly diff: one email a week with new agent tools, notable updates and grade changes, plus security alerts for tools you follow. Double opt-in, one-click unsubscribe.
About
Use cases: containers-kubernetes, debugging
Reviews
Write a reviewNo reviews yet. Installed it? Reviews come from verified installers only. How reviews work
Permissions
What this server can do and what it asks for, from its tool list and install config. Checked Oct 25, 2026.
- Tools
- 20 read · 3 write · 2 delete · 3 not yet classified
- Secrets
- None asked for
- Install scripts
- Not scanned yet
- Runs as
- Downloaded binary
Tools by what they do 28
Read from the source code; the running server may list different tools.
Read 20 · Look things up without changing anything.
find_servicesget_analysisget_connection_infoget_endpointsget_eventsget_healthget_historyget_http_trafficget_logsget_metricsget_podget_pod_logs
Show 8 more tools
get_quick_statusget_servicelist_contextslist_hostnameslist_k8s_namespaceslist_k8s_serviceslist_podslist_services
Write 3 · Create, change, send or run things.
add_namespaceadd_servicesync_service
Delete 2 · Delete, drop, revoke or wipe things.
remove_namespaceremove_service
Not yet classified 3 · We could not tell from the name and description.
diagnose_errorsreconnect_all_errorsreconnect_service
Network hosts it talks to 1
github.com· found in install command
Tools (28)
Read from the source code; the running server may differ. Descriptions are the server’s own words; hidden characters are shown as [U+…].
add_namespaceForward all services in a namespace to localhost. Adds /etc/hosts entries for each service. Returns list of discovered services with connection info.
add_serviceForward a single service to localhost. Returns local IP, hostnames (added to /etc/hosts), and mapped ports. Requires namespace and service_name.
diagnose_errorsDiagnose current errors with root cause analysis. Returns error types, affected pods, and specific fix suggestions.
find_servicesSearch forwarded services by name pattern, port number, or namespace. Returns matching services with connection info.
get_analysisFull analysis with issues, priorities, and recommended actions. Returns classified errors and specific tool calls to fix them. Best starting point for troubleshooting.
get_connection_infoGet connection details for a forwarded service: IP address, hostnames, ports, and environment variables. Use after add_service to get ready-to-use connection strings. Requires service_name.
get_endpointsGet endpoints for a Kubernetes service. Shows which pods are backing the service and their ready state. Useful for debugging service-to-pod routing.
get_eventsGet Kubernetes events for debugging. Shows scheduling, pulling, starting, killing events. Filter by resource kind (Pod, Service) and name. Critical for diagnosing startup failures.
get_healthGet kubefwd health: status (healthy/degraded/unhealthy), version, uptime, and service/error counts.
get_historyAccess event, error, or reconnection history. Filter by type and service key. Analyze patterns over time. Requires type ('events', 'errors', or 'reconnections').
get_http_trafficView HTTP requests through a forward: method, path, status code, response time. Debug API calls and verify connectivity. Requires service_key (e.g., 'myservice.namespace.context') or forward_key.
get_logsGet kubefwd log entries. Filter by level (debug/info/warn/error) or search text. Returns timestamped messages.
get_metricsGet bandwidth metrics: total bytes in/out, transfer rates, per-service breakdown. Shows network activity.
get_podGet detailed pod information including containers, status, conditions, resources, and events. Use to diagnose pod issues. Requires namespace and pod_name.
get_pod_logsGet logs from a Kubernetes pod. Useful for debugging services. Returns recent log lines from the pod's container. Requires namespace and pod_name. Get pod names from list_pods or get_service output.
Show 13 more tools
get_quick_statusFast health check returning ok/issues/error with message. Use as first check before taking action.
get_serviceGet detailed service info: all port forwards, pods, hostnames, traffic bytes/rates, and error state. Requires key (e.g., 'servicename.namespace.context').
list_contextsList Kubernetes contexts from kubeconfig with current context marked. Use to discover clusters before forwarding.
list_hostnamesList all /etc/hosts entries created by kubefwd. Shows hostname-to-IP mappings for each forwarded service.
list_k8s_namespacesList available Kubernetes namespaces with forwarding status. Use to discover what can be forwarded.
list_k8s_servicesList services in a namespace with type, ports, and forwarding status. Use to discover what can be forwarded. Requires namespace.
list_podsList Kubernetes pods with status, ready state, restarts, and age. Filter by label selector or service name. Essential for finding which pods back a service. Requires namespace.
list_servicesList all forwarded services with status. Returns service names, namespaces, contexts, forward counts, and error states.
reconnect_all_errorsReconnect all errored services at once. Returns count of services triggered.
reconnect_serviceReconnect a service to its pods. Use when service is in error state. Forces immediate reconnection attempt. Requires key (e.g., 'servicename.namespace.context').
remove_namespaceStop all service forwards in a namespace. Removes /etc/hosts entries and cleans up network interfaces.
remove_serviceStop forwarding a service. Removes /etc/hosts entries and releases the allocated IP. Requires key (e.g., 'servicename.namespace.context').
sync_serviceRe-sync pods for a service. Discovers pod changes and updates forwards. Use after deployments or pod restarts. Requires key (e.g., 'servicename.namespace.context').
Compare and alternatives
Featured in
Signals
- Stars
- 4,177
- Forks
- 240
- Open issues
- 1
- Contributors
- 51
- Last commit
- Oct 17, 2026 (11 days ago)
- Last release
- Oct 16, 2026 (12 days ago)
From GitHub (fetched Oct 24, 2026).
Details
- Registry name
io.github.txn2/kubefwd- Version
- 1.25.18
- Auth
- No auth
- Packages
- mcpb https://github.com/txn2/kubefwd/releases/download/v1.25.18/kubefwd-1.25.18-darwin-arm64.mcpbmcpb https://github.com/txn2/kubefwd/releases/download/v1.25.18/kubefwd-1.25.18-darwin-amd64.mcpbmcpb https://github.com/txn2/kubefwd/releases/download/v1.25.18/kubefwd-1.25.18-windows-amd64.mcpb
- License
- Apache-2.0
- Repository
- github.com/txn2/kubefwd
- First seen
- Oct 24, 2026
- Last checked
- Oct 24, 2026
More from txn2
- 0.626score
CLAUDE.md · txn2/kubefwd
txn2
CLAUDE.md from txn2/kubefwd: 424 lines covering Project Overview, Integration and Usage Patterns, TUI (Terminal User Interface), Git Policy and more.
TemplateAFreshness: A★ 4.2KClaude Code - 0.617score
MCP Trino
txn2
MCP server for Trino data warehouses.
ConnectorAFreshness: ALocal★ 5Claude Desktop - 0.568score
MCP Datahub
txn2
MCP server for DataHub data catalogs.
ConnectorBFreshness: BLocal★ 3Claude Desktop
Cite this page
Kubefwd MCP server. Agent Mart. https://agentmart.dev/connectors/txn2-kubefwd (last updated 2026-10-24)