io.github.CloudCorpRecords/guildchat
Discord guild and channel messaging via REST API v10: guilds, channels, messages and reactions.
Installation
Ajoutez ceci à la configuration MCP de votre client (Claude Desktop : claude_desktop_config.json ; Cursor : .cursor/mcp.json ; VS Code et les autres utilisent la même forme « mcpServers »).
@reneturcios/guildchatclaude mcp add guildchat -- npx -y @reneturcios/guildchat@0.1.0 mcp
{
"mcpServers": {
"guildchat": {
"command": "npx",
"args": [
"-y",
"@reneturcios/guildchat@0.1.0",
"mcp"
]
}
}
}
ghcr.io/cloudcorprecords/guildchat:0.1.0claude mcp add guildchat -- docker run -i --rm ghcr.io/cloudcorprecords/guildchat:0.1.0 mcp
{
"mcpServers": {
"guildchat": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"ghcr.io/cloudcorprecords/guildchat:0.1.0",
"mcp"
]
}
}
}
Documentation
Tirée du README du projet sur GitHub, actualisée chaque semaine. Les liens ouvrent GitHub.
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
| Tool | Input | Discord endpoint |
|---|---|---|
list_guilds | — | GET /users/@me/guilds |
get_guild | guild_id | GET /guilds/{id} |
list_channels | guild_id | GET /guilds/{id}/channels |
get_channel | channel_id | GET /channels/{id} |
send_message | channel_id, content | POST /channels/{id}/messages |
read_messages | channel_id, limit?, before? | GET /channels/{id}/messages |
edit_message | channel_id, message_id, content | PATCH /channels/{id}/messages/{mid} |
delete_message | channel_id, message_id | DELETE /channels/{id}/messages/{mid} |
add_reaction | channel_id, message_id, emoji | PUT /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.
Questions fréquentes
Qu'est-ce que io.github.CloudCorpRecords/guildchat ?
Discord guild and channel messaging via REST API v10: guilds, channels, messages and reactions.
Comment installer io.github.CloudCorpRecords/guildchat ?
Il s'exécute sur votre machine. Dans Claude Code : claude mcp add guildchat -- npx -y @reneturcios/guildchat@0.1.0 mcp. Pour les autres clients, collez la configuration JSON de cette page dans leurs réglages MCP.
Faut-il une clé API pour io.github.CloudCorpRecords/guildchat ?
Son entrée au registre n'indique aucune clé ni secret obligatoire. Certaines fonctions peuvent tout de même demander un compte auprès du service auquel il se connecte.
io.github.CloudCorpRecords/guildchat est-il open source ?
Oui. Son code est sur GitHub sous licence MIT.
Qui maintient io.github.CloudCorpRecords/guildchat ?
Il est publié par CloudCorpRecords. AI.tn le référence sans le maintenir ni le recommander.
Issu du registre MCP officiel. Être listé n'est pas une recommandation : vérifiez le code et les permissions d'un serveur avant de lui donner accès à vos données.