discord-selfbot-mcp 1.2.5 → 1.2.7

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Microck
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -11,7 +11,7 @@
 <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">
-  <img src="https://img.shields.io/badge/npm-%40discord--selfbot--mcp-orange" alt="npm">
+  <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>
@@ -190,7 +190,7 @@ powered by the robust `discord.py-self` library.
 | **relationships** | 4 | list_friends, send_friend_request, add_friend, remove_friend |
 | **presence** | 2 | set_status, set_activity |
 | **interactions** | 3 | send_slash_command, click_button, select_menu |
-| **threads** | 2 | create_thread, archive_thread |
+| **threads** | 5 | create_thread, send_thread_message, list_active_threads, read_thread_messages, archive_thread |
 | **members** | 5 | kick_member, ban_member, unban_member, add_role, remove_role |
 | **invites** | 3 | create_invite, list_invites, delete_invite |
 | **profile** | 1 | edit_profile |
@@ -298,14 +298,13 @@ built-in rate limiting to prevent account bans. configurable via environment var
 
 | variable | default | description |
 |----------|---------|-------------|
-| `RATE_LIMIT_ENABLED` | `false` | Enable/disable rate limiting |
+| `RATE_LIMIT_ENABLED` | `true` | Enable/disable rate limiting |
 | `RATE_LIMIT_MESSAGES_PER_MINUTE` | `10` | Max messages per minute |
 | `RATE_LIMIT_MESSAGES_PER_SECOND` | `1` | Max messages per second |
 | `RATE_LIMIT_ACTIONS_PER_MINUTE` | `5` | Max actions (joins, etc.) per minute |
 | `RATE_LIMIT_COOLDOWN` | `60` | Cooldown duration when limit hit (seconds) |
-| `RATE_LIMIT_RESPECT_GLOBAL` | `true` | Respect Discord's global rate limit |
 
-> **recommended**: Enable rate limiting (`RATE_LIMIT_ENABLED=true`) to reduce ban risk.
+> rate limiting is enabled by default to reduce ban risk. Only disable it if you are deliberately taking responsibility for raw Discord API pacing yourself.
 
 ---
 
@@ -330,11 +329,15 @@ discord_py_self_mcp/
 ├── main.py
 ├── setup.py
 ├── rate_limiter.py
+├── tool_utils.py
+├── cli_runtime.py
+├── logging_utils.py
 ├── captcha/
 │   └── solver.py
 └── tools/
     ├── channels.py
     ├── discrawl.py
+    ├── embed.py
     ├── guilds.py
     ├── interactions.py
     ├── invites.py
@@ -361,7 +364,7 @@ in addition to the mcp server, this package also provides a **skill/cli mode** f
 npm install -g discord-selfbot-mcp
 
 # create .env file
-echo "DISCORD_TOKEN=your_token" > .env
+echo "DISCORD_TOKEN=***" > .env
 
 # use skill mode (from package directory)
 python3 scripts/dcli.py send-message --channel 123 --content "Hello!"
@@ -388,4 +391,18 @@ see [SKILL.md](SKILL.md) for detailed documentation.
 
 ### license
 
-mit
+this project is licensed under the [mit license](./LICENSE).
+
+---
+
+### contributing
+
+issues and pull requests are welcome at [github.com/Microck/discord.py-self-mcp](https://github.com/Microck/discord.py-self-mcp).
+
+1. fork the repository
+2. create a feature branch (`git checkout -b feature/my-feature`)
+3. commit your changes (`git commit -m 'add my feature'`)
+4. push to the branch (`git push origin feature/my-feature`)
+5. open a pull request
+
+please ensure tests pass (`pytest`) before submitting.

package/SKILL.md

@@ -123,9 +123,6 @@ python3 scripts/dcli.py pin-message --channel CHANNEL_ID --message MESSAGE_ID
 # Create thread from message (in text channel)
 python3 scripts/dcli.py create-thread --channel CHANNEL_ID --name "Thread Name" --message MESSAGE_ID
 
-# Create standalone thread (in text channel)
-python3 scripts/dcli.py create-thread --channel CHANNEL_ID --name "Thread Name"
-
 # Create thread in forum channel (with initial content)
 python3 scripts/dcli.py create-thread --channel FORUM_CHANNEL_ID --name "Thread Name" --content "Initial post content"
 ```
@@ -176,11 +173,10 @@ python3 scripts/dcli.py read-recent-threads --guild GUILD_ID --within 4 --limit-
 
 #### Get User Info
 ```bash
-# Get current user info
+# Get current user info (supported in daemon mode)
 python3 scripts/dcli.py user-info
 
-# Get specific user info
-python3 scripts/dcli.py user-info --user USER_ID
+# Specific user lookup is not currently supported in daemon mode
 ```
 
 #### List Threads in Channel
@@ -248,7 +244,7 @@ Commands that support `--after` parameter accept the following formats:
 - **Daemon Mode**: Uses persistent connection for instant command execution
 - **Auto-Restart**: Daemon monitors its own code and restarts automatically when changes are detected
 - **Process Management**: Built-in commands to manage the daemon lifecycle
-- **Socket Communication**: Client and daemon communicate via Unix socket at `/tmp/discord-cli-daemon.sock`
+- **Socket Communication**: Client and daemon communicate via a private Unix socket under `$XDG_RUNTIME_DIR/discord-py-self-mcp` or `~/.local/state/discord-py-self-mcp`
 - **Rate Limiting**: Respected automatically by the underlying discord.py library
 
 ## Working with Forum Channels
@@ -294,7 +290,6 @@ python3 scripts/dcli.py daemon restart
 ```bash
 # Clean up and restart
 python3 scripts/dcli.py daemon stop
-rm /tmp/discord-cli-daemon.sock
 python3 scripts/dcli.py daemon start
 ```
 

package/package.json

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