Inspect Apollo endpoint coverage

Immutable Catalog Entry

This descriptor comes from the active versioned Portal catalog.

READapollo.get_endpoint_coverage

• Contract tier: agent_ready
• Risk: read
• Catalog version: 1.0.2
• Descriptor hash: 5facfba289bd06b3b48b2e47e5618817c75e2d48784294ee1b88fad93db9a712

Use this local read-only navigation tool to see which Apollo reference endpoints map to canonical tools, including method, path, documentation link, risk, and experimental status. It never contacts Apollo. Filter by category or include experimental endpoints when needed.

Request Body

{
  "jsonrpc": "2.0",
  "id": "apollo-get-endpoint-coverage-example",
  "method": "tools/call",
  "params": {
    "name": "apollo.get_endpoint_coverage",
    "arguments": {
      "category": "",
      "include_experimental": false
    }
  }
}

Arguments Schema

{
  "type": "object",
  "properties": {
    "category": {
      "anyOf": [
        {
          "type": "string",
          "description": "Optional manifest category filter."
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Optional manifest category filter."
    },
    "include_experimental": {
      "type": "boolean",
      "default": false,
      "description": "Include experimental/legacy endpoint rows."
    }
  },
  "additionalProperties": false
}

Output Schema

{
  "type": "object",
  "required": [
    "ok",
    "data",
    "error",
    "meta"
  ],
  "properties": {
    "ok": {
      "type": "boolean",
      "description": "Whether the requested operation completed successfully."
    },
    "data": {
      "anyOf": [
        {
          "anyOf": [
            {
              "type": "object",
              "additionalProperties": true
            },
            {
              "type": "array",
              "items": {}
            },
            {
              "type": "string"
            },
            {
              "type": "number"
            },
            {
              "type": "boolean"
            }
          ],
          "description": "Normalized provider or navigation result."
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Normalized provider or navigation result."
    },
    "meta": {
      "type": "object",
      "description": "Safe request, pagination, and truncation metadata.",
      "additionalProperties": true
    },
    "error": {
      "anyOf": [
        {
          "type": "object",
          "description": "Safe error details when ok is false.",
          "additionalProperties": true
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Safe error details when ok is false."
    }
  },
  "description": "Apollo MCP normalized response 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": "apollo-get-endpoint-coverage-example",
  "method": "tools/call",
  "params": {
    "name": "apollo.get_endpoint_coverage",
    "arguments": {
      "category": "",
      "include_experimental": 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": "apollo-get-endpoint-coverage-example",
  "method": "tools/call",
  "params": {
    "name": "apollo.get_endpoint_coverage",
    "arguments": {
      "category": "",
      "include_experimental": 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": "apollo-get-endpoint-coverage-example",
  "method": "tools/call",
  "params": {
    "name": "apollo.get_endpoint_coverage",
    "arguments": {
      "category": "",
      "include_experimental": false
    }
  }
}
response = requests.post(url, headers=headers, json=payload, timeout=60)
print(response.json())

Example Responses

200 Success

{
  "ok": true,
  "message": "Tool apollo.get_endpoint_coverage 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."
}