/doctor

description: "Diagnose MCP server connectivity — tests each server, reports status and impact in plain language, suggests fixes for issues."
tools:
  - Read
  - Grep
  - Glob
  - Bash
  - WebSearch
  - WebFetch
  - Task
  - mcp__plugin_bettercallclaude_bge-search__search_bge
  - mcp__bge-search__search_bge
  - mcp__plugin_bettercallclaude_entscheidsuche__search_decisions
  - mcp__entscheidsuche__search_decisions
  - mcp__plugin_bettercallclaude_fedlex-sparql__search_legislation
  - mcp__fedlex-sparql__search_legislation
  - mcp__plugin_bettercallclaude_legal-citations__validate_citation
  - mcp__legal-citations__validate_citation
  - mcp__plugin_bettercallclaude_onlinekommentar__search_commentaries
  - mcp__onlinekommentar__search_commentaries
  - mcp__plugin_bettercallclaude_legal-persona__legal_analyze
  - mcp__legal-persona__legal_analyze
  - mcp__plugin_bettercallclaude_tas-jurisprudence__cas_search
  - mcp__tas-jurisprudence__cas_search
  - mcp__plugin_bettercallclaude_workflows-ch__list_workflows
  - mcp__workflows-ch__list_workflows
  - mcp__plugin_bettercallclaude_ollama__ollama_check_status
  - mcp__ollama__ollama_check_status

BetterCallClaude — Diagnostics

You are invoked via `/bettercallclaude:doctor`. Diagnose the health of all BetterCallClaude MCP servers and report results in user-friendly language.

Step 1: Health Endpoint

Check the HTTP MCP gateway:

• Attempt to reach `https://mcp.bettercallclaude.ch/health`
• If the health check succeeds, note "Gateway online".
• If it fails, note "Gateway non raggiungibile" and the likely impact.

Step 2: Probe Each Server

For each of the 10 MCP servers, use a **two-stage approach**:

**Stage A — Tool availability**: Check whether the server's tools appear in your available tool list. If they do not appear, mark the server as "non connesso" immediately.

**Stage B — Lightweight call** (only if Stage A passed): Make one minimal call to confirm responsiveness.

| Server | What it provides | Test call | |--------|-----------------|-----------| | entscheidsuche | Ricerca sentenze cantonali e federali | `search_decisions` (minimal) | | bge-search | Ricerca sentenze Tribunale federale | `search_bge` (minimal) | | legal-citations | Verifica e formattazione citazioni | `validate_citation` (minimal) | | fedlex-sparql | Banca dati legislativa federale | `search_legislation` (minimal) | | onlinekommentar | Commentari giuridici online | `search_commentaries` (minimal) | | legal-persona | Analisi, strategia e drafting documenti legali svizzeri | `legal_analyze` (minimal) | | tas-jurisprudence | Lodi arbitrali CAS/TAS | `cas_search` (minimal) | | workflows-ch | Flussi di lavoro personalizzati | `list_workflows` with `{"user_id": "default"}` | | swiss-caselaw | Giurisprudenza, catene citazioni, dottrina | `search_decisions` (minimal) | | ollama | Classificatore privacy locale | `ollama_check_status` |

Step 3: Agent Route Probe

Steps 1–2 verify the connectors from the **main session**. This step verifies the **agent route** — the path that broke in v4.11.5, when plugin agents could not see any MCP tool ("No such tool available: mcp__fedlex-sparql__…") while the main session worked fine.

Dispatch the plugin's citation specialist agent via the Task tool (use its scoped name, e.g. `bettercallclaude:citation-specialist`) with exactly this prompt:

> Call the legal-citations MCP tool whose name ends in `validate_citation` with the citation "BGE 145 III 229". Do not use any other tool. Report back ONLY: (1) the exact tool name you called, (2) "OK" plus the returned citation, or the verbatim error message.

Interpret the result:

• Agent reports a tool name + "OK" → agent route healthy; note "Route agent: OK".
• Agent reports "No such tool available" (or cannot find any MCP tool ending in `validate_citation`) → **agent route broken**: plugin agents cannot reach the connectors even though the main session can. Tell the user to update BetterCallClaude to the latest version and re-run `/bettercallclaude:doctor`; if the problem persists, report it at https://github.com/fedec65/bettercallclaude/issues including this output.
• The Task tool is not available in the current context (e.g. inside a nested session) → mark the route as "non verificabile" and hint to re-run `/bettercallclaude:doctor` in a fresh top-level session.

Step 4: Display Results

Present results in the user's language, without technical jargon. Example (IT):

╔══════════════════════════════════════════════════════════╗
  BetterCallClaude — Diagnostica Servizi
╠══════════════════════════════════════════════════════════╣

  Servizio                       Stato        Impatto se assente
  ────────                       ─────        ──────────────────
  Sentenze federali (BGE)        ✓ attivo     —
  Sentenze cantonali             ✓ attivo     —
  Banca dati legislativa         ✓ attivo     —
  Verifica citazioni             ✓ attivo     —
  Commentari online              ✓ attivo     —
  Analisi documenti (MCP)        ✓ attivo     —
  Arbitrato sportivo (TAS)       ✓ attivo     —
  Flussi personalizzati          ✓ attivo     —
  Giurisprudenza svizzera        ✓ attivo     —
  Classificatore privacy         ✗ assente    Traduzioni/riassunti non filtrati localmente

  Gateway: https://mcp.bettercallclaude.ch — online
  Servizi attivi: 9/10
  Route agent (MCP via subagent): ✓ operativa

╚══════════════════════════════════════════════════════════╝

Adapt labels to DE/FR/EN based on user language.

Step 5: Guidance

All servers active:

> Tutti i servizi sono operativi. BetterCallClaude funziona a piena capacità.

Some servers unavailable:

For each unavailable server, explain in plain language:

| Server | Impact if unavailable | |--------|-----------------------| | entscheidsuche | Le ricerche di sentenze cantonali non sono disponibili. Le analisi si basano sulle conoscenze generali del modello. | | bge-search | La ricerca strutturata di sentenze del Tribu