> ## Documentation Index
> Fetch the complete documentation index at: https://docs.doglytdc.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# MCP tools · Discord

> Tools for the script's Discord bot. Secrets (Token and Client Secret) never leave the server: only whether they are saved or missing is shown.

Tools for the script's Discord bot. Secrets (Token and Client Secret) never leave the server: only whether they are saved or missing is shown.

| Tool | What it does | Type |
| - | - | - |
| `discord_status` | Shows whether the Token and Client Secret are saved in the server secrets (no values), whether the bot is connected to them, the commands and the addresses to paste into Discord. Owner only. | Read |
| `discord_connect_from_secrets` | Connects the bot to the server secrets (DISCORD\_BOT\_TOKEN/DISCORD\_CLIENT\_SECRET), checks the token with Discord and registers the commands. Never receives or returns secrets. Owner only. | Write |
| `discord_register_commands` | Registers the bot's slash commands with Discord again. Owner only. | Write |
| `discord_health` | Checklist for the Discord app (token, public key, Interactions URL, Redirect, server install, app-added notice, commands). No secrets. Owner only. | Read |
| `discord_fix_app` | Uses the Discord API to fix the server install (with the bot), the Interactions URL, the app-added notice and the commands. Owner only. | Write |

## discord\_status

**Bot status.** Shows whether the Token and Client Secret are saved in the server secrets (no values), whether the bot is connected to them, the commands and the addresses to paste into Discord. Owner only.

> [!NOTE]
>
> Read only: changes nothing. Confirmation belongs to the AI client; scopes and blocks still apply.

### Parameters

**script\_id** `string` *required*

Script ID (uuid)

### What it calls in the API

Por baixo, a ferramenta usa `GET /scripts/{script_id}/discord/env` da [API do Scripts](https://docs.doglytdc.dev/en/scripts/api.md). The response includes text and structuredContent, with secrets removed.

### Example

```json Request theme={null}
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "discord_status",
    "arguments": {
      "script_id": "8f0c2c1e-5b0a-4d2e-9a61-3f7d2b1c9e40"
    }
  }
}
```

```json Response theme={null}
{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "content": [
      {
        "type": "text",
        "text": "{ ...response JSON... }"
      }
    ],
    "isError": false
  }
}
```

## discord\_connect\_from\_secrets

**Connect with server secrets.** Connects the bot to the server secrets (DISCORD\_BOT\_TOKEN/DISCORD\_CLIENT\_SECRET), checks the token with Discord and registers the commands. Never receives or returns secrets. Owner only.

> [!NOTE]
>
> Writes or changes script data. Destructive action: review in your AI client before confirming. Confirmation belongs to the AI client; scopes and blocks still apply.

### Parameters

**script\_id** `string` *required*

Script ID (uuid)

### What it calls in the API

Por baixo, a ferramenta usa `POST /scripts/{script_id}/discord/env/connect` da [API do Scripts](https://docs.doglytdc.dev/en/scripts/api.md). The response includes text and structuredContent, with secrets removed.

### Example

```json Request theme={null}
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "discord_connect_from_secrets",
    "arguments": {
      "script_id": "8f0c2c1e-5b0a-4d2e-9a61-3f7d2b1c9e40"
    }
  }
}
```

```json Response theme={null}
{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "content": [
      {
        "type": "text",
        "text": "{ ...response JSON... }"
      }
    ],
    "isError": false
  }
}
```

## discord\_register\_commands

**Register commands.** Registers the bot's slash commands with Discord again. Owner only.

> [!NOTE]
>
> Writes or changes script data. Destructive action: review in your AI client before confirming. Confirmation belongs to the AI client; scopes and blocks still apply.

### Parameters

**script\_id** `string` *required*

Script ID (uuid)

### What it calls in the API

Por baixo, a ferramenta usa `POST /scripts/{script_id}/discord/commands` da [API do Scripts](https://docs.doglytdc.dev/en/scripts/api.md). The response includes text and structuredContent, with secrets removed.

### Example

```json Request theme={null}
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "discord_register_commands",
    "arguments": {
      "script_id": "8f0c2c1e-5b0a-4d2e-9a61-3f7d2b1c9e40"
    }
  }
}
```

```json Response theme={null}
{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "content": [
      {
        "type": "text",
        "text": "{ ...response JSON... }"
      }
    ],
    "isError": false
  }
}
```

## discord\_health

**Check the Discord app.** Checklist for the Discord app (token, public key, Interactions URL, Redirect, server install, app-added notice, commands). No secrets. Owner only.

> [!NOTE]
>
> Read only: changes nothing. Confirmation belongs to the AI client; scopes and blocks still apply.

### Parameters

**script\_id** `string` *required*

Script ID (uuid)

### What it calls in the API

Por baixo, a ferramenta usa `GET /scripts/{script_id}/discord/health` da [API do Scripts](https://docs.doglytdc.dev/en/scripts/api.md). The response includes text and structuredContent, with secrets removed.

### Example

```json Request theme={null}
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "discord_health",
    "arguments": {
      "script_id": "8f0c2c1e-5b0a-4d2e-9a61-3f7d2b1c9e40"
    }
  }
}
```

```json Response theme={null}
{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "content": [
      {
        "type": "text",
        "text": "{ ...response JSON... }"
      }
    ],
    "isError": false
  }
}
```

## discord\_fix\_app

**Fix the Discord app.** Uses the Discord API to fix the server install (with the bot), the Interactions URL, the app-added notice and the commands. Owner only.

> [!NOTE]
>
> Writes or changes script data. Destructive action: review in your AI client before confirming. Confirmation belongs to the AI client; scopes and blocks still apply.

### Parameters

**script\_id** `string` *required*

Script ID (uuid)

### What it calls in the API

Por baixo, a ferramenta usa `POST /scripts/{script_id}/discord/app/fix` da [API do Scripts](https://docs.doglytdc.dev/en/scripts/api.md). The response includes text and structuredContent, with secrets removed.

### Example

```json Request theme={null}
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "discord_fix_app",
    "arguments": {
      "script_id": "8f0c2c1e-5b0a-4d2e-9a61-3f7d2b1c9e40"
    }
  }
}
```

```json Response theme={null}
{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "content": [
      {
        "type": "text",
        "text": "{ ...response JSON... }"
      }
    ],
    "isError": false
  }
}
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.