Audit One Discord Channel Day
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:
36dd230c5e3057479e9091efcf8064e24afe5e3b89b0f777918b313e85293dc4
Use this when you need a categorized summary of one channel day. This reads bounded channel history without changing state through Discord's API and returns audit totals, classifications, samples, date bounds, and warnings. It requires a configured Discord bot and guild with the relevant permissions.
Request Body
{
"jsonrpc": "2.0",
"id": "discord-channel-daily-audit-example",
"method": "tools/call",
"params": {
"name": "discord.channel_daily_audit",
"arguments": {
"channel_id": "channel_id_123",
"date": "date_example",
"limit": "limit_example",
"timezone_name": "timezone_name_example",
"include_threads": ""
}
}
}
Arguments Schema
{
"type": "object",
"title": "channel_daily_audit input",
"required": [
"channel_id"
],
"properties": {
"date": {
"type": "string",
"title": "Date",
"default": "",
"description": "Calendar date in YYYY-MM-DD; empty selects the current date in the chosen timezone."
},
"limit": {
"type": "string",
"title": "Limit",
"default": "",
"description": "Maximum records or matches, expressed as a positive decimal string unless typed as integer."
},
"channel_id": {
"type": "string",
"title": "Channel Id",
"description": "Discord channel snowflake; empty uses the primary channel only where documented."
},
"timezone_name": {
"type": "string",
"title": "Timezone Name",
"default": "",
"description": "IANA timezone used for daily boundaries; empty uses configured audit timezone."
},
"include_threads": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "string"
}
],
"title": "Include Threads",
"default": false,
"description": "When true, include eligible thread messages."
}
},
"description": "Validated input for the Discord MCP channel_daily_audit tool."
}
Output Schema
{
"oneOf": [
{
"type": "object",
"required": [
"ok",
"data",
"meta"
],
"properties": {
"ok": {
"const": true
},
"data": {
"type": "object",
"properties": {
"date": {
"type": [
"string",
"null"
],
"description": "Provider data field date returned by channel_daily_audit."
},
"blockers": {
"type": "array",
"items": {},
"description": "Provider data field blockers returned by channel_daily_audit."
},
"timezone": {
"type": [
"string",
"null"
],
"description": "Provider data field timezone returned by channel_daily_audit."
},
"decisions": {
"type": "array",
"items": {},
"description": "Provider data field decisions returned by channel_daily_audit."
},
"questions": {
"type": "array",
"items": {},
"description": "Provider data field questions returned by channel_daily_audit."
},
"range_utc": {
"type": [
"object",
"null"
],
"description": "Provider data field range_utc returned by channel_daily_audit.",
"additionalProperties": true
},
"channel_id": {
"type": [
"string",
"null"
],
"description": "Provider data field channel_id returned by channel_daily_audit."
},
"highlights": {
"type": "array",
"items": {},
"description": "Provider data field highlights returned by channel_daily_audit."
},
"links_topN": {
"type": "array",
"items": {},
"description": "Provider data field links_topN returned by channel_daily_audit."
},
"top_authors": {
"type": "array",
"items": {},
"description": "Provider data field top_authors returned by channel_daily_audit."
},
"channel_name": {
"type": [
"string",
"null"
],
"description": "Provider data field channel_name returned by channel_daily_audit."
},
"message_count": {
"type": [
"integer",
"null"
],
"description": "Provider data field message_count returned by channel_daily_audit."
},
"unique_authors": {
"type": [
"integer",
"null"
],
"description": "Provider data field unique_authors returned by channel_daily_audit."
},
"include_threads": {
"type": [
"boolean",
"null"
],
"description": "Provider data field include_threads returned by channel_daily_audit."
},
"attachments_count": {
"type": [
"integer",
"null"
],
"description": "Provider data field attachments_count returned by channel_daily_audit."
}
},
"description": "audit totals, classifications, samples, date bounds, and warnings",
"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-channel-daily-audit-example",
"method": "tools/call",
"params": {
"name": "discord.channel_daily_audit",
"arguments": {
"channel_id": "channel_id_123",
"date": "date_example",
"limit": "limit_example",
"timezone_name": "timezone_name_example",
"include_threads": ""
}
}
}'
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-channel-daily-audit-example",
"method": "tools/call",
"params": {
"name": "discord.channel_daily_audit",
"arguments": {
"channel_id": "channel_id_123",
"date": "date_example",
"limit": "limit_example",
"timezone_name": "timezone_name_example",
"include_threads": ""
}
}
}),
});
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-channel-daily-audit-example",
"method": "tools/call",
"params": {
"name": "discord.channel_daily_audit",
"arguments": {
"channel_id": "channel_id_123",
"date": "date_example",
"limit": "limit_example",
"timezone_name": "timezone_name_example",
"include_threads": ""
}
}
}
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.channel_daily_audit 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."
}