Server diagnostics

Run the doctor

Changed on

Runs the full doctor workflow — probe → connect → initialize → capabilities → primitives — and returns a step-by-step report. The richest signal for "is this server healthy, and why not."

post/projects/{projectId}/servers/{serverId}/doctor

Request

  • Base URL
    https://app.mcpjam.com/api/v1
  • URL
    https://app.mcpjam.com/api/v1/projects/{projectId}/servers/{serverId}/doctor
  • Auth
    HTTP bearer

Path parameters

projectIdstring required

ID of the hosted project that contains the server.

serverIdstring required

ID of the server inside the project.

Request body

object required

Response

Doctor report. status summarizes the outcome; per-step detail is in checks.

generatedAtstring date-time required

When the report was generated.

status'ready' | 'oauth_required' | 'partial' | 'error' required

Overall outcome. partial means the server connected but some primitive listings failed.

probeobject nullable

Transport-level probe result (HTTP reachability, protocol hints), or null when skipped.

initInfoobject nullable
capabilitiesobject nullable

The server's negotiated MCP capabilities.

resourceTemplatesobject[]

Changes

  • 8e393fd5825fRevision changes
    • warning

      added the new CONFLICT enum value to the response property for the response status

    • warning

      added the new CONFLICT enum value to the response property for the response status

    • warning

      added the new CONFLICT enum value to the response property for the response status

    • warning

      added the new CONFLICT enum value to the response property for the response status

    • warning

      added the new CONFLICT enum value to the response property for the response status

    • warning

      added the new CONFLICT enum value to the response property for the response status

    • warning

      added the new CONFLICT enum value to the response property for the response status

    • warning

      added the new CONFLICT enum value to the response property for the response status