discord-selfbot-mcp 1.2.8 → 1.3.0

package/README.md

@@ -186,6 +186,7 @@ powered by the robust `discord.py-self` library.
 | **system** | 2 | get_user_info, list_guilds |
 | **messages** | 6 | send_message, read_messages, search_messages, edit_message, delete_message, get_message_attachments |
 | **channels** | 3 | create_channel, delete_channel, list_channels |
+| **dms** | 1 | list_dm_channels |
 | **voice** | 2 | join_voice_channel, leave_voice_channel |
 | **relationships** | 4 | list_friends, send_friend_request, add_friend, remove_friend |
 | **presence** | 2 | set_status, set_activity |
@@ -197,11 +198,42 @@ powered by the robust `discord.py-self` library.
 | **reactions** | 2 | add_reaction, remove_reaction |
 | **discrawl** | 7 | run_discrawl, discrawl_doctor, discrawl_status, discrawl_sync, discrawl_search, discrawl_messages, discrawl_mentions |
 
+### direct messages
+
+`list_dm_channels` enumerates your open 1:1 and group DM channels so you can
+discover a `channel_id` instead of needing to know it in advance. Each row is
+`<channel_id> - [dm|group] <recipient display> (id=<user_id>) [BOT]`. Optional
+args: `include_groups` (default `true`) and `name_contains` (case-insensitive
+filter on recipient name/handle), e.g. find the DM with a person by name and
+feed the id straight into `read_messages` / `send_message`.
+
+### slash commands
+
+`send_slash_command` invokes an application command in a channel or DM. Pass
+`application_id` (the bot's user/application ID) for reliable resolution; in a DM
+with a bot it is inferred automatically. The command and any options are
+resolved from the application's registered command list
+(`GET /applications/{id}/commands`), which works for ordinary guild-installed
+bots whose commands the per-channel `/` search index does not return. Subcommands
+are space-separated in `command_name` (e.g. `"config set"`). Example:
+
+```json
+{
+  "channel_id": "123456789012345678",
+  "command_name": "remind",
+  "application_id": "987654321098765432",
+  "options": { "text": "stand up", "when": "in 10 minutes" }
+}
+```
+
 ### discrawl integration
 
 Use `run_discrawl` to execute local `discrawl` commands directly from MCP.
 Use typed tools for common operations (`discrawl_sync`, `discrawl_search`, `discrawl_messages`, etc.) when you want structured params.
-This fork prefers a sibling checkout at `../discrawl-self/bin/discrawl` when present, then falls back to `discrawl` in `PATH`.
+By default this MCP uses the Microck fork at `../discrawl-self/bin/discrawl`:
+`https://github.com/Microck/discrawl-self`. It does not silently fall back to a
+global `discrawl` from `PATH`; set `DISCRAWL_BIN` or the tool `binary` argument
+when you intentionally want another executable.
 
 Example tool call payload:
 
@@ -229,7 +261,7 @@ Typed tool payload example:
 
 Optional env var:
 
-- `DISCRAWL_BIN` - custom path to discrawl executable. This overrides the default fork-first lookup.
+- `DISCRAWL_BIN` - custom path to discrawl executable. This overrides the default Microck fork lookup.
 
 ### attachment access
 
@@ -336,6 +368,7 @@ discord_py_self_mcp/
 │   └── solver.py
 └── tools/
     ├── channels.py
+    ├── dms.py
     ├── discrawl.py
     ├── embed.py
     ├── guilds.py

package/SKILL.md

@@ -66,8 +66,11 @@ This server also exposes dedicated MCP tools to run local `discrawl` commands:
 - `discrawl_messages`
 - `discrawl_mentions`
 
-By default this MCP prefers a sibling fork build at `../discrawl-self/bin/discrawl`, then falls back to `discrawl` in `PATH`.
-Use `DISCRAWL_BIN` if you want to override that:
+By default this MCP uses the Microck fork build at `../discrawl-self/bin/discrawl`
+from `https://github.com/Microck/discrawl-self`. It does not silently fall back
+to a global `discrawl` from `PATH`.
+
+Use `DISCRAWL_BIN` if you want to intentionally override that:
 
 ```bash
 DISCRAWL_BIN=/absolute/path/to/discrawl

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "discord-selfbot-mcp",
-  "version": "1.2.8",
+  "version": "1.3.0",
   "description": "Discord Selfbot MCP server - Node.js wrapper for Python implementation",
   "main": "index.js",
   "bin": {

package/server.json

@@ -6,14 +6,14 @@
     "url": "https://github.com/Microck/discord.py-self-mcp",
     "source": "github"
   },
-  "version": "1.2.8",
+  "version": "1.3.0",
   "packages": [
     {
       "registryType": "npm",
       "registryBaseUrl": "https://registry.npmjs.org",
       "identifier": "discord-selfbot-mcp",
       "runtimeHint": "python",
-      "version": "1.2.8",
+      "version": "1.3.0",
       "packageArguments": [],
       "environmentVariables": [
         {
@@ -38,7 +38,7 @@
         },
         {
           "name": "DISCRAWL_BIN",
-          "description": "Optional path to discrawl executable for the run_discrawl MCP tool. Overrides the default preference for ../discrawl-self/bin/discrawl.",
+          "description": "Optional path to discrawl executable for the run_discrawl MCP tool. Overrides the default Microck fork path at ../discrawl-self/bin/discrawl.",
           "format": "string",
           "isRequired": false
         }