Doctor

Doctor is the in-app health drawer. It reports the current local instance status from the backend health service; it is not a separate scheduled diagnostics subsystem.

Open it from the layout status button / Settings area. The drawer calls the backend each time it opens or when you click refresh.

Current Backend API

curl http://localhost:18088/api/v1/system/health \
  -H "Authorization: Bearer <token>"

Response shape:

{
  "code": 200,
  "msg": "success",
  "data": {
    "overall": "healthy",
    "checks": [
      {
        "name": "default-model",
        "status": "healthy",
        "message": "Default model: qwen-plus",
        "action": null
      }
    ]
  }
}

overall is one of healthy, warning, or error. Each check has:

Field	Meaning
name	Stable check key such as default-model, database, browser, provider:<id>, mcp:<name>
status	healthy, warning, or error
message	Short diagnostic text shown in the drawer
action	Optional { label, route } hint for where to fix the issue

What It Checks Today

The current SystemHealthService checks:

Check	What it verifies	Typical action
Default model	A default model is configured and loadable	/settings/models
Providers	API-key providers are configured when required	/settings/models
Enabled MCP servers	Enabled MCP servers have a successful connection result	/settings/mcp-servers
Database initialization	First-run bootstrap has completed	/setup
Browser diagnostics	Browser launch pre-flight for browser tooling	/api/v1/system/browser-health

There is also a direct browser diagnostics endpoint:

curl http://localhost:18088/api/v1/system/browser-health \
  -H "Authorization: Bearer <token>"

Not Implemented In The Current Source Tree

Older docs mentioned /api/v1/doctor/run, /api/v1/doctor/checks, /api/v1/doctor/history, scheduled background Doctor runs, mate_doctor_check, and mate_doctor_check_history. Those endpoints and tables are not present in the current backend source. Use /api/v1/system/health for the current health surface.

Related Pages

• API Reference - source-aligned route inventory
• Models - model/provider setup
• MCP - MCP server setup
• Security & Approval - Tool Guard and approval behavior