Skip to content

alii/neuron

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

1 Commit
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

neuron

A Discord MCP server that gives AI agents full control of a Discord bot — messages, channels, roles, threads, forums, events, webhooks, reactions, moderation, image generation, and real-time voice.

Built with Bun, discord.js, and the MCP TypeScript SDK.

Features

  • Messaging — send, edit, delete, pin, bulk-delete, fetch history, wait for new events in real time
  • Channels & threads — create/edit/delete channels, threads, and forum posts
  • Server management — roles, members, invites, webhooks, scheduled events, moderation (kick/ban/timeout)
  • Voice — join voice channels, speak with ElevenLabs TTS, or run a full conversational voice agent that listens and replies
  • Images — generate images with OpenAI and post them straight to a channel
  • Event streamingdiscord_wait_for_events blocks until new messages/reactions/etc. arrive, so an agent can run a continuous listen-and-respond loop

Setup

  1. Create a bot in the Discord Developer Portal, enable the Message Content, Server Members, and Presence privileged intents as needed, and invite it to your server.

  2. Install dependencies:

    bun install
  3. Configure credentials:

    cp .env.example .env
    # then fill in DISCORD_BOT_TOKEN (required) and the optional keys
    Variable Required Purpose
    DISCORD_BOT_TOKEN yes Bot token for the Discord API
    ELEVENLABS_API_KEY for voice TTS and the conversational voice agent
    ELEVENLABS_VOICE_ID no Voice to speak with (has a default)
    OPENAI_API_KEY for images discord_generate_image
    IMAGE_OUTPUT_DIR no Where to save generated images

Usage

The server speaks MCP over stdio. Point any MCP client at it — for example, with Claude Code:

claude mcp add discord -- bun run /path/to/neuron/src/index.ts

Or in an mcpServers config:

{
  "mcpServers": {
    "discord": {
      "command": "bun",
      "args": ["run", "/path/to/neuron/src/index.ts"]
    }
  }
}

You can also run it directly to check that it starts:

bun start

Tools

All 57 tools

Messagesdiscord_send_message, discord_get_message, discord_get_messages, discord_edit_message, discord_delete_message, discord_bulk_delete_messages, discord_pin_message, discord_unpin_message, discord_get_pinned_messages, discord_wait_for_events

Reactionsdiscord_add_reaction, discord_remove_reaction, discord_get_reactions

Channels & threadsdiscord_get_channel, discord_get_channels, discord_create_channel, discord_edit_channel, discord_delete_channel, discord_create_thread, discord_delete_thread, discord_archive_thread, discord_unarchive_thread, discord_add_thread_member, discord_remove_thread_member, discord_create_forum_post

Guilds & membersdiscord_get_guild, discord_get_guilds, discord_get_member, discord_get_members, discord_get_user, discord_kick_member, discord_ban_member, discord_timeout_member

Rolesdiscord_get_roles, discord_create_role, discord_edit_role, discord_delete_role, discord_add_role, discord_remove_role

Invites & webhooksdiscord_get_invites, discord_create_invite, discord_delete_invite, discord_create_webhook, discord_send_webhook_message, discord_delete_webhook

Eventsdiscord_get_events, discord_create_event, discord_delete_event

Voicediscord_join_voice, discord_leave_voice, discord_speak, discord_get_voice_status, discord_get_voice_members, discord_start_voice_agent, discord_stop_voice_agent, discord_get_voice_agent_status

Miscdiscord_generate_image, discord_set_avatar

License

MIT

About

Discord bot MCP for Claude Code

Resources

License

Stars

5 stars

Watchers

0 watching

Forks

Releases

No releases published

Packages

 
 
 

Contributors