Check Discord Provider Health
Immutable Catalog Entry
This descriptor comes from the active versioned Portal catalog.
- Contract tier:
agent_ready - Risk:
read - Catalog version:
discord-2026.07.12.3 - Descriptor hash:
adc1c15bdee204e3a6738623a1458d924ebb9c2dd9999b93c1180bb259af8277
Use this when you need a live permission and readiness check for the configured guild. This reads bot, guild, channel, permission, and rate-limit state through Discord's API and returns a red/yellow/green report, safe configuration flags, warnings, and capabilities. It requires a configured Discord bot and guild with the relevant permissions.
Request Body
{
"jsonrpc": "2.0",
"id": "discord-discord-health-check-example",
"method": "tools/call",
"params": {
"name": "discord.discord_health_check",
"arguments": {
"guild_id": "guild_id_123"
}
}
}
Arguments Schema
{
"type": "object",
"title": "discord_health_check input",
"properties": {
"guild_id": {
"type": "string",
"title": "Guild Id",
"default": "",
"description": "Optional Discord guild snowflake override; otherwise uses request-scoped configuration."
}
},
"description": "Validated input for the Discord MCP discord_health_check tool."
}
Output Schema
{
"oneOf": [
{
"type": "object",
"required": [
"ok",
"data",
"meta"
],
"properties": {
"ok": {
"const": true
},
"data": {
"type": "object",
"properties": {
"bot": {
"type": [
"object",
"null"
],
"description": "Provider data field bot returned by discord_health_check.",
"additionalProperties": true
},
"guild": {
"type": [
"object",
"null"
],
"description": "Provider data field guild returned by discord_health_check.",
"additionalProperties": true
},
"status": {
"type": [
"string",
"null"
],
"description": "Provider data field status returned by discord_health_check."
},
"healthy": {
"type": [
"boolean",
"null"
],
"description": "Provider data field healthy returned by discord_health_check."
},
"warnings": {
"type": "array",
"items": {},
"description": "Provider data field warnings returned by discord_health_check."
},
"capabilities": {
"type": [
"object",
"null"
],
"description": "Provider data field capabilities returned by discord_health_check.",
"additionalProperties": true
},
"discord_config": {
"type": [
"object",
"null"
],
"description": "Provider data field discord_config returned by discord_health_check.",
"additionalProperties": true
},
"last_successful_api_at": {
"type": [
"string",
"null"
],
"description": "Provider data field last_successful_api_at returned by discord_health_check."
}
},
"description": "a red/yellow/green report, safe configuration flags, warnings, and capabilities",
"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
- Node.js
- Python
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-discord-health-check-example",
"method": "tools/call",
"params": {
"name": "discord.discord_health_check",
"arguments": {
"guild_id": "guild_id_123"
}
}
}'
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-discord-health-check-example",
"method": "tools/call",
"params": {
"name": "discord.discord_health_check",
"arguments": {
"guild_id": "guild_id_123"
}
}
}),
});
const data = await response.json();
console.log(data);
import requests
url = 'https://portal.madpanda3d.com/api/mcp'
headers = {
'Authorization': 'Bearer mad_live_***',
'Content-Type': 'application/json',
}
payload = {
"jsonrpc": "2.0",
"id": "discord-discord-health-check-example",
"method": "tools/call",
"params": {
"name": "discord.discord_health_check",
"arguments": {
"guild_id": "guild_id_123"
}
}
}
response = requests.post(url, headers=headers, json=payload, timeout=60)
print(response.json())
Example Responses
- 200 Success
- 502 Upstream Error
{
"ok": true,
"message": "Tool discord.discord_health_check executed successfully.",
"note": "Response shape varies by MCP tool. Inspect live responses for exact fields."
}
{
"ok": false,
"classification": "upstream_http_error",
"message": "Upstream MCP returned a non-success status."
}