Get Discord Tool Usage

Immutable Catalog Entry

This descriptor comes from the active versioned Portal catalog.

READdiscord.get_tool_usage

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

Use this when you need the lossless descriptor for one tool. This reads one canonical descriptor from memory through Discord's API and returns complete parameters, output, risk, confirmation, and follow-up guidance. It requires an authenticated MAD MCP Portal request, but does not contact Discord.

Request Body

{
  "jsonrpc": "2.0",
  "id": "discord-get-tool-usage-example",
  "method": "tools/call",
  "params": {
    "name": "discord.get_tool_usage",
    "arguments": {
      "tool_name": "tool_name_example"
    }
  }
}

Arguments Schema

{
  "type": "object",
  "title": "get_tool_usage input",
  "required": [
    "tool_name"
  ],
  "properties": {
    "tool_name": {
      "type": "string",
      "title": "Tool Name",
      "description": "Canonical tool name or exact compatibility alias from this manifest."
    }
  },
  "description": "Validated input for the Discord MCP get_tool_usage tool."
}

Output Schema

{
  "oneOf": [
    {
      "type": "object",
      "required": [
        "ok",
        "data",
        "meta"
      ],
      "properties": {
        "ok": {
          "const": true
        },
        "data": {
          "type": "object",
          "properties": {
            "descriptor": {
              "type": [
                "object",
                "null"
              ],
              "description": "Provider data field descriptor returned by get_tool_usage.",
              "additionalProperties": true
            },
            "nextAction": {
              "type": [
                "object",
                "null"
              ],
              "description": "Provider data field nextAction returned by get_tool_usage.",
              "additionalProperties": true
            }
          },
          "description": "complete parameters, output, risk, confirmation, and follow-up guidance",
          "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-tool-usage-example",
  "method": "tools/call",
  "params": {
    "name": "discord.get_tool_usage",
    "arguments": {
      "tool_name": "tool_name_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-tool-usage-example",
  "method": "tools/call",
  "params": {
    "name": "discord.get_tool_usage",
    "arguments": {
      "tool_name": "tool_name_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-tool-usage-example",
  "method": "tools/call",
  "params": {
    "name": "discord.get_tool_usage",
    "arguments": {
      "tool_name": "tool_name_example"
    }
  }
}
response = requests.post(url, headers=headers, json=payload, timeout=60)
print(response.json())

Example Responses

200 Success

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