discord-selfbot-mcp 1.2.8 → 1.4.0

package/README.md

@@ -9,12 +9,9 @@
 </p>
 
 <p align="center">
-  <img src="https://img.shields.io/badge/license-MIT-green" alt="license">
-  <img src="https://img.shields.io/badge/language-python-blue" alt="language">
-  <a href="https://www.npmjs.com/package/discord-selfbot-mcp"><img src="https://img.shields.io/npm/v/discord-selfbot-mcp?color=orange&label=npm" alt="npm"></a>
-  <img src="https://img.shields.io/badge/mcp-sdk-orange" alt="mcp">
-  <img src="https://img.shields.io/badge/skill-cli-purple" alt="skill">
-  <a href="https://github.com/Microck/opencode-studio"><img src="https://img.shields.io/badge/opencode-studio-brown?logo=data%3Aimage%2Fpng%3Bbase64%2CiVBORw0KGgoAAAANSUhEUgAAAA4AAAAOCAYAAAAfSC3RAAABiElEQVR4nF2Sv0tWcRTGPyeVIpCWwmyJGqQagsqCsL2hhobsD3BvdWhoj/6CiIKaoqXBdMjKRWwQgqZ%2BokSvkIhg9BOT9xPn9Vx79cD3cu6953zP8zznCQB1V0S01d3AKeAKcBVYA94DjyJioru2k9SHE%2Bqc%2Bkd9rL7yf7TUm%2BpQ05yPUM%2Bo626Pp%2BqE2q7GGfWrOpjNnWnAOPAGeAK8Bb4U5D3AJ%2BAQsAAMAHfVvl7gIrAf2Kjiz8BZYB3YC/wFpoGDwHfgEnA0oU7tgHiheEShyXxY/Vn/n6ljye8DcBiYAloRcV3tAdrV1xMRG%2Bo94DywCAwmx33AJHASWK7iiAjzNFOBl7WapPYtYdyo8RlLqVpOVPvq9KoH1NUuOneycaRefqnP1ftdUyiOt5KS%2BqLWdDpVzTXMl5It4Jr6u%2BQ/nhyBc8C7jpowGxGvmxuPqT9qyYuFIKdP71B8WT3SOKexXLrntvqxq3BefaiuFMQ0wqZftxl3M78MjBasfiDN/SAi0kFbtf8ACtKBWZBDoJEAAAAASUVORK5CYII%3D" alt="Add with OpenCode Studio" /></a>
+  <a href="https://github.com/Microck/discord.py-self-mcp/releases"><img src="https://img.shields.io/github/v/release/Microck/discord.py-self-mcp?display_name=tag&style=flat-square&label=release&color=000000" alt="release"></a>
+  <a href="https://www.npmjs.com/package/discord-selfbot-mcp"><img src="https://flat.badgen.net/npm/dt/discord-selfbot-mcp?label=downloads&color=000000" alt="npm downloads"></a>
+  <a href="LICENSE"><img src="https://img.shields.io/badge/license-mit-000000?style=flat-square" alt="license"></a>
 </p>
 
 <p align="center">
@@ -186,6 +183,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 +195,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 +258,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 +365,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.4.0",
   "description": "Discord Selfbot MCP server - Node.js wrapper for Python implementation",
   "main": "index.js",
   "bin": {

package/scripts/daemon.py

@@ -46,7 +46,11 @@ from discord_py_self_mcp.cli_runtime import (
     ensure_runtime_dir,
 )
 from discord_py_self_mcp.logging_utils import log_to_stderr
-from discord_py_self_mcp.tool_utils import NON_MESSAGEABLE_TEXT, validate_message_content
+from discord_py_self_mcp.tool_utils import (
+    NON_MESSAGEABLE_TEXT,
+    build_reply_kwargs,
+    validate_message_content,
+)
 from discord_py_self_mcp.tools.embed import serialize_attachment, serialize_message
 
 DAEMON_SCRIPT = SCRIPT_DIR / "daemon.py"
@@ -203,7 +207,9 @@ class DiscordDaemon:
                 )
             if cmd == "send_message":
                 return await self._send_message(
-                    args.get("channel_id"), args.get("content")
+                    args.get("channel_id"),
+                    args.get("content"),
+                    args.get("reply_to_message_id"),
                 )
             if cmd == "get_message_attachments":
                 return await self._get_message_attachments(
@@ -313,7 +319,7 @@ class DiscordDaemon:
         messages.reverse()
         return {"messages": messages}
 
-    async def _send_message(self, channel_id, content):
+    async def _send_message(self, channel_id, content, reply_to_message_id=None):
         content_error = validate_message_content(content or "")
         if content_error:
             return {"error": content_error}
@@ -326,7 +332,8 @@ class DiscordDaemon:
         if not isinstance(channel, discord.abc.Messageable):
             return {"error": NON_MESSAGEABLE_TEXT}
 
-        message = await channel.send(content)
+        send_kwargs = build_reply_kwargs(reply_to_message_id, channel_id)
+        message = await channel.send(content, **send_kwargs)
         return {"message_id": message.id, "success": True}
 
     async def _get_message_attachments(

package/scripts/dcli.py

@@ -4,7 +4,7 @@ Usage: python3 dcli.py <command> [args]
 
 Commands:
   daemon <start|stop|restart|status>  - Manage daemon process
-  send-message --channel ID --content "msg"
+  send-message --channel ID --content "msg" [--reply-to MESSAGE_ID]
   read-messages --channel ID [--limit N] [--after TIME]
   get-message-attachments --channel ID --message ID [--attachment-index N] [--download --output-dir DIR]
   list-guilds
@@ -244,11 +244,14 @@ def cmd_get_message_attachments(
         print(f"  {destination}")
 
 
-def cmd_send_message(channel_id, content):
+def cmd_send_message(channel_id, content, reply_to_message_id=None):
+    args = {"channel_id": channel_id, "content": content}
+    if reply_to_message_id is not None:
+        args["reply_to_message_id"] = reply_to_message_id
     result = send_request(
         {
             "command": "send_message",
-            "args": {"channel_id": channel_id, "content": content},
+            "args": args,
         }
     )
     if "error" in result:
@@ -554,6 +557,7 @@ def main():
     send_parser = subparsers.add_parser("send-message", help="Send a message")
     send_parser.add_argument("--channel", "-c", required=True, type=int, help="Channel ID")
     send_parser.add_argument("--content", "-m", required=True, help="Message content")
+    send_parser.add_argument("--reply-to", "-r", type=int, default=None, help="Message ID to reply to")
 
     read_parser = subparsers.add_parser("read-messages", help="Read messages from channel")
     read_parser.add_argument("--channel", "-c", required=True, type=int, help="Channel ID")
@@ -635,7 +639,7 @@ def main():
     if args.command == "daemon":
         cmd_daemon(args.action)
     elif args.command == "send-message":
-        cmd_send_message(args.channel, args.content)
+        cmd_send_message(args.channel, args.content, args.reply_to)
     elif args.command == "read-messages":
         cmd_read_messages(args.channel, args.limit, args.after)
     elif args.command == "get-message-attachments":

package/server.json

@@ -6,14 +6,14 @@
     "url": "https://github.com/Microck/discord.py-self-mcp",
     "source": "github"
   },
-  "version": "1.2.8",
+  "version": "1.4.0",
   "packages": [
     {
       "registryType": "npm",
       "registryBaseUrl": "https://registry.npmjs.org",
       "identifier": "discord-selfbot-mcp",
       "runtimeHint": "python",
-      "version": "1.2.8",
+      "version": "1.4.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
         }