Get Discord Daily Audit Status

Immutable Catalog Entry

This descriptor comes from the active versioned Portal catalog.

READdiscord.daily_audit_job_status

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

Use this when you need progress or accumulated results for a daily audit. This reads an in-memory audit record without contacting Discord through Discord's API and returns cursor, status, completed counts, timing, and optional results. It requires an authenticated MAD MCP Portal request, but does not contact Discord.

Request Body

{
  "jsonrpc": "2.0",
  "id": "discord-daily-audit-job-status-example",
  "method": "tools/call",
  "params": {
    "name": "discord.daily_audit_job_status",
    "arguments": {
      "task_id": "task_id_123",
      "include_results": ""
    }
  }
}

Arguments Schema

{
  "type": "object",
  "title": "daily_audit_job_status input",
  "required": [
    "task_id"
  ],
  "properties": {
    "task_id": {
      "type": "string",
      "title": "Task Id",
      "description": "Opaque task identifier returned by the matching submit tool."
    },
    "include_results": {
      "anyOf": [
        {
          "type": "boolean"
        },
        {
          "type": "string"
        }
      ],
      "title": "Include Results",
      "default": false,
      "description": "When true, include accumulated audit results."
    }
  },
  "description": "Validated input for the Discord MCP daily_audit_job_status 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 daily_audit_job_status."
            },
            "error": {
              "description": "Provider data field error returned by daily_audit_job_status."
            },
            "status": {
              "type": [
                "string",
                "null"
              ],
              "description": "Provider data field status returned by daily_audit_job_status."
            },
            "results": {
              "type": [
                "object",
                "null"
              ],
              "description": "Provider data field results returned by daily_audit_job_status.",
              "additionalProperties": true
            },
            "task_id": {
              "type": [
                "string",
                "null"
              ],
              "description": "Provider data field task_id returned by daily_audit_job_status."
            },
            "timezone": {
              "type": [
                "string",
                "null"
              ],
              "description": "Provider data field timezone returned by daily_audit_job_status."
            },
            "created_at": {
              "type": [
                "string",
                "null"
              ],
              "description": "Provider data field created_at returned by daily_audit_job_status."
            },
            "finished_at": {
              "type": [
                "string",
                "null"
              ],
              "description": "Provider data field finished_at returned by daily_audit_job_status."
            },
            "total_channels": {
              "type": [
                "integer",
                "null"
              ],
              "description": "Provider data field total_channels returned by daily_audit_job_status."
            },
            "completed_count": {
              "type": [
                "integer",
                "null"
              ],
              "description": "Provider data field completed_count returned by daily_audit_job_status."
            },
            "next_channel_id": {
              "type": [
                "string",
                "null"
              ],
              "description": "Provider data field next_channel_id returned by daily_audit_job_status."
            },
            "remaining_count": {
              "type": [
                "integer",
                "null"
              ],
              "description": "Provider data field remaining_count returned by daily_audit_job_status."
            }
          },
          "description": "cursor, status, completed counts, timing, and optional results",
          "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-daily-audit-job-status-example",
  "method": "tools/call",
  "params": {
    "name": "discord.daily_audit_job_status",
    "arguments": {
      "task_id": "task_id_123",
      "include_results": ""
    }
  }
}'

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-daily-audit-job-status-example",
  "method": "tools/call",
  "params": {
    "name": "discord.daily_audit_job_status",
    "arguments": {
      "task_id": "task_id_123",
      "include_results": ""
    }
  }
}),
});
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-daily-audit-job-status-example",
  "method": "tools/call",
  "params": {
    "name": "discord.daily_audit_job_status",
    "arguments": {
      "task_id": "task_id_123",
      "include_results": ""
    }
  }
}
response = requests.post(url, headers=headers, json=payload, timeout=60)
print(response.json())

Example Responses

200 Success

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