{"$schema":"https://wellknown.network/schemas/agent-record-v1.json","schemaVersion":"1","id":"ag_zsrnzg64ukf4","handle":"troubleshoot-mcp-server","url":"https://wellknown.network/agents/troubleshoot-mcp-server","links":{"self":"https://wellknown.network/agents/troubleshoot-mcp-server/record.json","html":"https://wellknown.network/agents/troubleshoot-mcp-server","markdown":"https://wellknown.network/agents/troubleshoot-mcp-server/record.md","api":"https://wellknown.network/api/v1/agents/troubleshoot-mcp-server","status":"https://wellknown.network/api/v1/agents/troubleshoot-mcp-server/status","claim":"https://wellknown.network/agents/troubleshoot-mcp-server/claim","claimApi":"https://wellknown.network/api/v1/claims","claimDescriptor":"https://wellknown.network/agents/troubleshoot-mcp-server/claim.json","badge":"https://wellknown.network/agents/troubleshoot-mcp-server/badge.svg","openapi":"https://wellknown.network/openapi.json","history":"https://wellknown.network/api/v1/agents/troubleshoot-mcp-server/history","tools":"https://wellknown.network/api/v1/agents/troubleshoot-mcp-server/tools"},"ard":{"identifier":"urn:air::server:troubleshoot-mcp-server","type":"application/mcp-server-card+json"},"kind":"mcp_server","declared":{"name":"troubleshoot-mcp-server","summary":"MCP server for Kubernetes support bundles","description":"# MCP Server for Kubernetes Support Bundles\n\n[![License](https://img.shields.io/badge/License-Apache%202.0-blue.svg)](LICENSE)\n[![Python Version](https://img.shields.io/badge/python-3.13-blue)](https://www.python.org/downloads/)\n\nA Model Context Protocol (MCP) server for AI models to interact with Kubernetes support bundles. This server enables AI models to analyze and troubleshoot Kubernetes clusters by exploring support bundles generated by the [Troubleshoot](https://troubleshoot.sh/) tool.\n\n## Features\n\n- 🚀 **Bundle Management**: Initialize and manage Kubernetes support bundles\n- 🎮 **Command Execution**: Run kubectl commands against bundle's API server\n- 📁 **File Explorer**: Navigate and search files within the bundle\n- 🔐 **Secure Authentication**: Token-based authentication for bundle access\n- 🐳 **Container Support**: Run as a containerized application\n- ⚡ **Single Bundle Mode**: Stateless operation for ephemeral/serverless deployments\n\n## Single Bundle Mode (Stateless Operation)\n\nFor stateless/ephemeral deployments (Temporal workflows, serverless functions, container-per-request architectures), enable **Single Bundle Mode**:\n\n```bash\nexport MCP_SINGLE_BUNDLE_MODE=true\nexport PRESERVE_BUNDLES=true\nexport MCP_BUNDLE_STORAGE=/persistent-storage/bundles\n```\n\n### What is Single Bundle Mode?\n\nSingle Bundle Mode eliminates in-memory bundle state tracking by treating the presence of a bundle on disk as the source of truth. This enables:\n\n- **Automatic Bundle Restoration**: When the server starts, it auto-activates the bundle persisted on disk\n- **Stateless Server Restarts**: Each server restart automatically uses the persisted bundle without re-initialization\n- **Single Bundle Invariant**: Only one bundle can exist at a time, preventing state confusion\n- **Seamless Temporal/Serverless Integration**: Works perfectly with short-lived server instances\n\n### Usage Pattern\n\n```bash\n# Activity 1: Initialize bundle\n# Server starts → downloads bundle → exits\ninitialize_bu…","publisher":null,"homepage":"https://github.com/chrisns/troubleshoot-mcp-server","repository":"https://github.com/chrisns/troubleshoot-mcp-server","version":"1.15.1","license":null,"protocols":["mcp"],"tags":["mcp","kubernetes","troubleshoot","support-bundle","ai","claude","debugging"],"pricing":null,"endpoints":[{"url":"pypi:troubleshoot-mcp-server","type":"package_pypi","auth":null,"probeable":false}],"skills":null,"tools":null,"extra":null,"attribution":{"kind":"pypi","name":"pypi","repoUrl":"pypi","summary":"pypi","version":"pypi","description":"pypi","homepageUrl":"pypi"}},"derived":{"capabilities":[{"slug":"infra.cloud","name":"Cloud Platforms","confidence":1,"provenance":"declared"},{"slug":"code.debugging","name":"Debugging","confidence":1,"provenance":"declared"}],"categories":["code","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":"troubleshoot-mcp-server","registry":"pypi","observedAt":"2026-11-04T03:27:45.874Z","publishedAt":"2025-10-13T22:30:35.285939Z","latestVersion":"1.15.1"},"toolSurface":null,"endpointFacts":[]},"verification":{"claimed":false,"claimedAt":null,"proofs":[]},"provenance":{"sources":[{"source":"pypi","key":"troubleshoot-mcp-server","url":"https://pypi.org/project/troubleshoot-mcp-server/","firstSeenAt":"2026-09-10T14:23:21.114Z","fetchedAt":"2026-11-04T03:25:32.072Z","normalizedAt":"2026-11-04T03:25:32.072Z"}]},"firstSeenAt":"2026-09-10T14:23:21.114Z","updatedAt":"2026-11-04T03:27:45.874Z"}