Get Discord Endpoint Coverage

Immutable Catalog Entry

This descriptor comes from the active versioned Portal catalog.

READdiscord.get_endpoint_coverage

• Contract tier: agent_ready
• Risk: read
• Catalog version: discord-2026.07.12.3
• Descriptor hash: f0233969a22e13dd7e37136ced53aa1dbd92fee515c46ff4a08c0a5b04411301

Use this when you need to understand covered and excluded Discord API areas. This reads the maintained coverage matrix from memory through Discord's API and returns official links, coverage state, tools, configuration, and gap reasons. It requires an authenticated MAD MCP Portal request, but does not contact Discord.

Request Body

{
  "jsonrpc": "2.0",
  "id": "discord-get-endpoint-coverage-example",
  "method": "tools/call",
  "params": {
    "name": "discord.get_endpoint_coverage",
    "arguments": {
      "feature": "feature_example"
    }
  }
}

Arguments Schema

{
  "type": "object",
  "title": "get_endpoint_coverage input",
  "properties": {
    "feature": {
      "type": "string",
      "title": "Feature",
      "default": "",
      "description": "Input parameter feature for get_endpoint_coverage; use the documented Discord value format."
    }
  },
  "description": "Validated input for the Discord MCP get_endpoint_coverage tool."
}

Output Schema

{
  "oneOf": [
    {
      "type": "object",
      "required": [
        "ok",
        "data",
        "meta"
      ],
      "properties": {
        "ok": {
          "const": true
        },
        "data": {
          "type": "object",
          "properties": {
            "count": {
              "type": [
                "integer",
                "null"
              ],
              "description": "Provider data field count returned by get_endpoint_coverage."
            },
            "filter": {
              "type": [
                "string",
                "null"
              ],
              "description": "Provider data field filter returned by get_endpoint_coverage."
            },
            "coverage": {
              "type": "array",
              "items": {},
              "description": "Provider data field coverage returned by get_endpoint_coverage."
            },
            "serviceId": {
              "type": [
                "string",
                "null"
              ],
              "description": "Provider data field serviceId returned by get_endpoint_coverage."
            },
            "retrievedAt": {
              "type": [
                "string",
                "null"
              ],
              "description": "Provider data field retrievedAt returned by get_endpoint_coverage."
            },
            "catalogVersion": {
              "type": [
                "string",
                "null"
              ],
              "description": "Provider data field catalogVersion returned by get_endpoint_coverage."
            }
          },
          "description": "official links, coverage state, tools, configuration, and gap reasons",
          "additionalProperties": true
        },
        "meta": {
          "type": "object",
          "required": [
            "duration_ms",
            "rate_limit",
            "warnings"
          ],
          "properties": {
            "guild_id": {
              "type": "string"
            },
            "warnings": {
              "type": "array",
              "items": {
                "type": "string"
              }
            },
            "thread_id": {
              "type": "string"
            },
            "channel_id": {
              "type": "string"
            },
            "rate_limit": {
              "type": "object",
              "additionalProperties": true
            },
            "request_id": {
              "type": "string"
            },
            "duration_ms": {
              "type": "integer",
              "minimum": 0
            }
          },
          "description": "Safe execution metadata containing no credentials or raw headers.",
          "additionalProperties": true
        }
      },
      "additionalProperties": false
    },
    {
      "type": "object",
      "required": [
        "ok",
        "error",
        "meta"
      ],
      "properties": {
        "ok": {
          "const": false
        },
        "meta": {
          "type": "object",
          "required": [
            "duration_ms",
            "rate_limit",
            "warnings"
          ],
          "properties": {
            "guild_id": {
              "type": "string"
            },
            "warnings": {
              "type": "array",
              "items": {
                "type": "string"
              }
            },
            "thread_id": {
              "type": "string"
            },
            "channel_id": {
              "type": "string"
            },
            "rate_limit": {
              "type": "object",
              "additionalProperties": true
            },
            "request_id": {
              "type": "string"
            },
            "duration_ms": {
              "type": "integer",
              "minimum": 0
            }
          },
          "description": "Safe execution metadata containing no credentials or raw headers.",
          "additionalProperties": true
        },
        "error": {
          "type": "object",
          "required": [
            "type",
            "message"
          ],
          "properties": {
            "type": {
              "type": "string"
            },
            "message": {
              "type": "string"
            },
            "diagnostics": {
              "type": "object",
              "additionalProperties": true
            },
            "required_perms": {
              "type": "array",
              "items": {
                "type": "string"
              }
            },
            "discord_error_code": {
              "type": "integer"
            }
          },
          "additionalProperties": false
        }
      },
      "additionalProperties": false
    }
  ],
  "title": "Discord MCP provider result",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "description": "Normalized success or semantic-error response; ok=false is a failed call."
}

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": "discord-get-endpoint-coverage-example",
  "method": "tools/call",
  "params": {
    "name": "discord.get_endpoint_coverage",
    "arguments": {
      "feature": "feature_example"
    }
  }
}'

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": "discord-get-endpoint-coverage-example",
  "method": "tools/call",
  "params": {
    "name": "discord.get_endpoint_coverage",
    "arguments": {
      "feature": "feature_example"
    }
  }
}),
});
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": "discord-get-endpoint-coverage-example",
  "method": "tools/call",
  "params": {
    "name": "discord.get_endpoint_coverage",
    "arguments": {
      "feature": "feature_example"
    }
  }
}
response = requests.post(url, headers=headers, json=payload, timeout=60)
print(response.json())

Example Responses

200 Success

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