{"$schema":"https://wellknown.network/schemas/agent-record-v1.json","schemaVersion":"1","id":"ag_3dsn48pz8mn8","handle":"k8s-mcp-extension","url":"https://wellknown.network/agents/k8s-mcp-extension","links":{"self":"https://wellknown.network/agents/k8s-mcp-extension/record.json","html":"https://wellknown.network/agents/k8s-mcp-extension","markdown":"https://wellknown.network/agents/k8s-mcp-extension/record.md","api":"https://wellknown.network/api/v1/agents/k8s-mcp-extension","status":"https://wellknown.network/api/v1/agents/k8s-mcp-extension/status","claim":"https://wellknown.network/agents/k8s-mcp-extension/claim","claimApi":"https://wellknown.network/api/v1/claims","claimDescriptor":"https://wellknown.network/agents/k8s-mcp-extension/claim.json","badge":"https://wellknown.network/agents/k8s-mcp-extension/badge.svg","openapi":"https://wellknown.network/openapi.json","history":"https://wellknown.network/api/v1/agents/k8s-mcp-extension/history","tools":"https://wellknown.network/api/v1/agents/k8s-mcp-extension/tools"},"ard":{"identifier":"urn:air::server:k8s-mcp-extension","type":"application/mcp-server-card+json"},"kind":"mcp_server","declared":{"name":"k8s-mcp-extension","summary":"MCP server for Kubernetes command execution, node inspection, and diagnostics","description":"# K8s MCP Server\n\nMCP server for Kubernetes command execution, node inspection, and node-level diagnostics. Extension of [k8s-mcp-server](https://github.com/alexei-led/k8s-mcp-server) by alexei-led.\n\n## Features\n\n- validated wrappers around `kubectl`, `helm`, `istioctl`, and `argocd`\n- node-aware kubeconfig selection through `K8S_NODE_PREFIX_MAPPING`\n- `run_checkup_on_node` for `kubectl node-shell ... checkup -n`\n- `get_logs_on_node` for collecting `dmesg`, `journalctl`, `/var/log/*`, and `/var/crash`\n- Kubernetes node inspection tools for status, labels, pods, and resources\n\n## Configuration\n\nSet `K8S_NODE_PREFIX_MAPPING` to a JSON object that maps a node prefix to a kubeconfig file name:\n\n```json\n{\n  \"node-a\": \"cluster-a.config\",\n  \"edge\": \"edge-cluster.config\"\n}\n```\n\nThe kubeconfig files are resolved relative to `K8S_KUBECONFIG_DIR`, which defaults to `~/.kube`.\n\n## Example MCP Client Configuration\n\nWhen installing from PyPI, you can use the package-matched command name `k8s-mcp-extension`.\nThe legacy `k8s-mcp-server` command remains available for backward compatibility.\n\n```json\n{\n  \"mcpServers\": {\n    \"k8s-server\": {\n      \"command\": \"k8s-mcp-extension\",\n      \"cwd\": \"/absolute/path/to/project\",\n      \"env\": {\n        \"K8S_KUBECONFIG_DIR\": \"/path/to/.kube\",\n        \"K8S_NODE_PREFIX_MAPPING\": \"{\\\"node-a\\\": \\\"cluster-a.config\\\", \\\"edge\\\": \\\"edge-cluster.config\\\"}\",\n        \"K8S_MCP_TIMEOUT\": \"600\"\n      }\n    }\n  }\n}\n```\n\n## Development\n\nCreate the environment and run checks:\n\n```bash\nuv sync --extra dev\n.venv/bin/python -m pytest\n.venv/bin/python -m ruff check\n```\n\nRun the server locally:\n\n```bash\n.venv/bin/python -m k8s_mcp_server\n```\n\nAfter installing the package, either console script works:\n\n```bash\nk8s-mcp-extension\nk8s-mcp-server\n```","publisher":null,"homepage":null,"repository":null,"version":"0.1.1","license":null,"protocols":["mcp"],"tags":["kubernetes","mcp","diagnostics","operations"],"pricing":null,"endpoints":[{"url":"pypi:k8s-mcp-extension","type":"package_pypi","auth":null,"probeable":false}],"skills":null,"tools":null,"extra":null,"attribution":{"kind":"pypi","name":"pypi","summary":"pypi","version":"pypi","description":"pypi"}},"derived":{"capabilities":[{"slug":"infra.cloud","name":"Cloud Platforms","confidence":1,"provenance":"declared"},{"slug":"dev.package-management","name":"Packages & Dependencies","confidence":0.768,"provenance":"derived"},{"slug":"dev.terminal","name":"Terminal & Shell","confidence":0.745,"provenance":"derived"}],"categories":["dev","infra"],"language":"en"},"observed":{"status":"unknown","statusReason":"Distributed as a package to run locally; no network endpoint to check.","lastOkAt":null,"lastProbedAt":null,"statusComputedAt":null,"reliability30d":null,"latestObservations":[],"tools":null,"package":{"name":"k8s-mcp-extension","registry":"pypi","observedAt":"2026-10-28T08:27:59.508Z","publishedAt":"2026-04-16T16:09:20.314538Z","latestVersion":"0.1.1"},"toolSurface":null,"endpointFacts":[]},"verification":{"claimed":false,"claimedAt":null,"proofs":[]},"provenance":{"sources":[{"source":"pypi","key":"k8s-mcp-extension","url":"https://pypi.org/project/k8s-mcp-extension/","firstSeenAt":"2026-09-09T22:22:57.016Z","fetchedAt":"2026-10-28T08:26:06.850Z","normalizedAt":"2026-10-28T08:26:06.850Z"}]},"firstSeenAt":"2026-09-09T22:22:57.016Z","updatedAt":"2026-10-28T08:27:59.508Z"}