Mcp Health Check

Immutable Catalog Entry

This descriptor comes from the active versioned Portal catalog.

READgoogle.mcp_health_check

• Contract tier: agent_ready
• Risk: read
• Catalog version: google-2026.07.12.2
• Descriptor hash: 49810634e892fc3cfcac6de2b6bafb1fda02c425c2dfc991957ad9f6aea36d46

Use this diagnostic tool to verify Google OAuth readiness, scopes, cache state, and optional safe API checks. It never returns credential values. It reads the configured user's Google data through per-request OAuth, does not mutate provider state, and returns a normalized bounded envelope.

Request Body

{
  "jsonrpc": "2.0",
  "id": "google-mcp-health-check-example",
  "method": "tools/call",
  "params": {
    "name": "google.mcp_health_check",
    "arguments": {
      "doc_id": "doc_id_123",
      "sheet_id": "sheet_id_123",
      "slide_id": "slide_id_123",
      "warm_all": false,
      "run_checks": false
    }
  }
}

Arguments Schema

{
  "type": "object",
  "title": "mcp_health_checkArguments",
  "properties": {
    "doc_id": {
      "type": "string",
      "title": "Doc Id",
      "default": "",
      "description": "Optional document ID for deeper Docs health check."
    },
    "sheet_id": {
      "type": "string",
      "title": "Sheet Id",
      "default": "",
      "description": "Optional spreadsheet ID for deeper Sheets health check."
    },
    "slide_id": {
      "type": "string",
      "title": "Slide Id",
      "default": "",
      "description": "Optional presentation ID for deeper Slides health check."
    },
    "warm_all": {
      "type": "boolean",
      "title": "Warm All",
      "default": false,
      "description": "Whether to warm all supported Google service clients."
    },
    "run_checks": {
      "type": "boolean",
      "title": "Run Checks",
      "default": true,
      "description": "Whether to call safe Google API health checks."
    }
  },
  "additionalProperties": false
}

Output Schema

{
  "type": "object",
  "required": [
    "ok",
    "data",
    "error",
    "meta"
  ],
  "properties": {
    "ok": {
      "type": "boolean",
      "description": "Whether the local or Google provider operation completed successfully."
    },
    "data": {
      "anyOf": [
        {
          "type": "object",
          "additionalProperties": true
        },
        {
          "type": "array",
          "items": {}
        },
        {
          "type": "string"
        },
        {
          "type": "number"
        },
        {
          "type": "boolean"
        },
        {
          "type": "null"
        }
      ],
      "description": "Bounded local navigation or Google provider result when ok is true."
    },
    "meta": {
      "type": "object",
      "description": "Safe timing, pagination, cache, request, and truncation metadata.",
      "additionalProperties": true
    },
    "error": {
      "anyOf": [
        {
          "type": "object",
          "additionalProperties": true
        },
        {
          "type": "null"
        }
      ],
      "description": "Safe structured error when ok is false."
    }
  },
  "description": "Google MCP normalized operation envelope.",
  "additionalProperties": false
}

Code Examples

cURL

curl -X POST 'https://portal.madpanda3d.com/api/mcp' \
  -H 'Authorization: Bearer mad_live_***' \
  -H 'Content-Type: application/json' \
  -d '{
  "jsonrpc": "2.0",
  "id": "google-mcp-health-check-example",
  "method": "tools/call",
  "params": {
    "name": "google.mcp_health_check",
    "arguments": {
      "doc_id": "doc_id_123",
      "sheet_id": "sheet_id_123",
      "slide_id": "slide_id_123",
      "warm_all": false,
      "run_checks": false
    }
  }
}'

Node.js

const response = await fetch('https://portal.madpanda3d.com/api/mcp', {
  method: 'POST',
  headers: {
    Authorization: 'Bearer mad_live_***',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
  "jsonrpc": "2.0",
  "id": "google-mcp-health-check-example",
  "method": "tools/call",
  "params": {
    "name": "google.mcp_health_check",
    "arguments": {
      "doc_id": "doc_id_123",
      "sheet_id": "sheet_id_123",
      "slide_id": "slide_id_123",
      "warm_all": false,
      "run_checks": false
    }
  }
}),
});
const data = await response.json();
console.log(data);

Python

import requests

url = 'https://portal.madpanda3d.com/api/mcp'
headers = {
    'Authorization': 'Bearer mad_live_***',
    'Content-Type': 'application/json',
}
payload = {
  "jsonrpc": "2.0",
  "id": "google-mcp-health-check-example",
  "method": "tools/call",
  "params": {
    "name": "google.mcp_health_check",
    "arguments": {
      "doc_id": "doc_id_123",
      "sheet_id": "sheet_id_123",
      "slide_id": "slide_id_123",
      "warm_all": false,
      "run_checks": false
    }
  }
}
response = requests.post(url, headers=headers, json=payload, timeout=60)
print(response.json())

Example Responses

200 Success

{
  "ok": true,
  "message": "Tool google.mcp_health_check executed successfully.",
  "note": "Response shape varies by MCP tool. Inspect live responses for exact fields."
}

502 Upstream Error

{
  "ok": false,
  "classification": "upstream_http_error",
  "message": "Upstream MCP returned a non-success status."
}