Back to Browse

Guildchat MCP Server

Developer ToolsModerate5.6MCP RegistryLocal
Free

Server data from the Official MCP Registry

Discord guild and channel messaging via REST API v10: guilds, channels, messages and reactions.

About

Discord guild and channel messaging via REST API v10: guilds, channels, messages and reactions.

Security Report

5.6
Moderate5.6Moderate Risk

guildchat is a small, focused Discord REST v10 client that authenticates via a DISCORD_TOKEN environment variable with no hardcoded secrets, no shell execution, and no dynamic code evaluation. Its network access is confined to the Discord API base (overridable via DISCORD_API_BASE), and its write tools (send, edit, delete, react) are expected for a chat-bot server. Findings are limited to minor notes: the configurable API base could redirect the bot token if misconfigured, and error messages echo upstream response detail. Supply chain analysis found 4 known vulnerabilities in dependencies (0 critical, 2 high severity). Package verification found 1 issue.

8 files analyzed ยท 9 issues found

Security scores are indicators to help you make informed decisions, not guarantees. Always review permissions before connecting any MCP server.

Permissions Required

This plugin requests these system permissions. Most are normal for its category.

HTTP Network Access

Connects to external APIs or services over the internet.

env_vars

Check that this permission is expected for this type of plugin.

How to Install

Add this to your MCP configuration file:

{
  "mcpServers": {
    "io-github-cloudcorprecords-guildchat": {
      "args": [
        "-y",
        "@reneturcios/guildchat"
      ],
      "command": "npx"
    }
  }
}

Documentation

View on GitHub

From the project's GitHub README.

guildchat

guildchat is a small Discord client for agents: it covers the part of Discord that community chat work actually needs โ€” guilds, channels, plain-text messages, and reactions โ€” and maps each tool 1:1 to a Discord REST API v10 endpoint. It is a defined core subset, not a full Discord integration: there is no voice, no thread or forum management, no role or permission editing, no member moderation, no webhooks, no slash-command registration, and no gateway event stream.

Every call is made as a bot, with Authorization: Bot <DISCORD_TOKEN>. Set DISCORD_TOKEN before starting the server; a call made without it fails with an error naming the variable. The API base defaults to https://discord.com/api/v10 and can be overridden with DISCORD_API_BASE.

Install

npx @reneturcios/guildchat list_guilds
docker run -i ghcr.io/cloudcorprecords/guildchat

CLI

guildchat list_guilds
guildchat get_guild <guild_id>
guildchat list_channels <guild_id>
guildchat send_message <channel_id> hello everyone
guildchat read_messages <channel_id> --limit 25
guildchat add_reaction <channel_id> <message_id> ๐Ÿ‘
guildchat get_current_user
guildchat --version

Exit codes: 0 success, 1 API error, 2 usage error.

MCP server

npx -y @reneturcios/guildchat mcp
{
  "mcpServers": {
    "guildchat": {
      "command": "npx",
      "args": ["-y", "@reneturcios/guildchat", "mcp"],
      "env": { "DISCORD_TOKEN": "your-bot-token" }
    }
  }
}

Tools

ToolInputDiscord endpoint
list_guildsโ€”GET /users/@me/guilds
get_guildguild_idGET /guilds/{id}
list_channelsguild_idGET /guilds/{id}/channels
get_channelchannel_idGET /channels/{id}
send_messagechannel_id, contentPOST /channels/{id}/messages
read_messageschannel_id, limit?, before?GET /channels/{id}/messages
edit_messagechannel_id, message_id, contentPATCH /channels/{id}/messages/{mid}
delete_messagechannel_id, message_idDELETE /channels/{id}/messages/{mid}
add_reactionchannel_id, message_id, emojiPUT /channels/{id}/messages/{mid}/reactions/{emoji}/@me
get_current_userโ€”GET /users/@me

Reaction emoji are URL-encoded into the request path, as Discord requires. Upstream HTTP errors are reported as tool errors with the status and response detail.

Development

npm install
npm run build
npm test

Tests run entirely on fake-fetch fixtures; no network and no real bot token are used.

License

MIT โ€” see LICENSE.

Reviews

No reviews yet

Be the first to review this server!