← All toolsCommunicationdiscordAll editions

DISCORD_READ

Read recent messages from a Discord channel.

Parameters

NameTypeRequiredDescription
channel_idstringyesChannel ID to read from
countinteger—Number of messages (default 10, max 100)
beforestring—Get messages before this message ID

How to use it

You normally trigger this by describing what you want in chat — the agent selects DISCORD_READ automatically. For example:

Try saying
“discord my discord”

In a workflow

As a step in a multi-step workflow DAG:

json
{
  "id": "s1",
  "agent": "discord",
  "action": "DISCORD_READ",
  "args": {
    "channel_id": "…",
    "count": 5,
    "before": "…"
  },
  "depends_on": [],
  "outputs": []
}

Direct call

For scripting, call it directly via POST /execute_tool. Every tool returns { success, message, data }.

bash
curl -X POST http://127.0.0.1:8000/execute_tool \
  -H "Content-Type: application/json" \
  -d '{"tool_name":"DISCORD_READ","args":{"channel_id":"…","count":5,"before":"…"}}'

Part of the discord plugin. Browse the full Plugin & Tool Catalog or the relevant feature guide.