Guildchat

io.github.CloudCorpRecordsPublished by GitHub account CloudCorpRecordsv0.1.0Updated Nov 3, 2026

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

VerifiedSTDIODesktop onlyCommunication & Collaboration

Overview

Guildchat's local MCP server; no sign-in required; STDIO.

No AI overview yet: these facts come from the registry entry and the server itself.

Installation

In SourceWeft

  1. Open Guildchat in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.

Other MCP clients

Follow the launch instructions in the repository.

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

bash
npx @reneturcios/guildchat list_guildsdocker run -i ghcr.io/cloudcorprecords/guildchat

CLI

bash
guildchat list_guildsguildchat get_guild <guild_id>guildchat list_channels <guild_id>guildchat send_message <channel_id> hello everyoneguildchat read_messages <channel_id> --limit 25guildchat add_reaction <channel_id> <message_id> 👍guildchat get_current_userguildchat --version

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

MCP server

bash
npx -y @reneturcios/guildchat mcp
json
{  "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

bash
npm installnpm run buildnpm test

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

License

MIT — see LICENSE.

Source: README.md at commit c90b5d4

Tools

0
SourceWeft has not started this package in its sandbox yet, so its tools are not known.

Version history

1
  1. v0.1.0LatestNov 3, 2026

Score

50% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 days25 pts

    Keep the endpoint answering the MCP handshake; SourceWeft probes it every 30 days.

  • Auth declared10 pts

    Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.

  • Tools listed15 pts

    Answer tools/list without a credential, or ship a package that starts in a sandbox without one.

  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts