limitless-reign-mcp

v1.0.7

Published

2 months ago

Turn any Discord.js bot into a full MCP server with 280+ tools. Supports Claude, ChatGPT, Cursor, Windsurf, and all MCP-compatible AI clients.

Limitless Reign MCP

AI-Powered Discord Bot Control | 280+ Tools | Works with Claude, ChatGPT, Cursor

Why Limitless Reign MCP?

Stop writing Discord bot commands. Just tell AI what you want.

You:  "Set up my gaming server with channels and automod"

AI:   ✓ Created #rules, #announcements, #general
      ✓ Created Gaming voice channels  
      ✓ Set up automod for spam/slurs
      ✓ Created Moderator and Member roles
      Done! Your server is ready.

The most complete Discord MCP integration:

116 Discord tools - Every Discord.js v14 API
Any AI client - Claude, ChatGPT, Cursor, Windsurf, GPT Actions
Zero config - One command to start
Open source - MIT license, free forever

🚀 One Command Setup

npx limitless-reign --token YOUR_BOT_TOKEN

That's it. Server runs at http://localhost:3000. Connect your AI and go.

Go to discord.com/developers/applications
Create app or select existing
Go to Bot → Reset Token → Copy
Add bot to server with Administrator permission

🎯 What AI Can Do

Messages & Content

| Ask AI | What Happens | |--------|--------------| | "Announce the new update in #general" | Sends formatted message | | "Create a poll: What game tonight?" | Creates interactive poll | | "Delete spam from the last hour" | Bulk deletes messages | | "Pin the rules message" | Pins to channel |

Server Setup

| Ask AI | What Happens | |--------|--------------| | "Create a gaming server layout" | Creates categories + channels | | "Set up roles for staff and members" | Creates role hierarchy | | "Make #admin visible only to mods" | Sets channel permissions | | "Add automod to block spam" | Creates automod rules |

Member Management

| Ask AI | What Happens | |--------|--------------| | "Timeout toxic_user for 1 day" | Applies timeout | | "Give VIP role to our supporters" | Adds roles to members | | "Kick inactive members" | Removes members | | "Who has the Admin role?" | Lists members |

Advanced

| Ask AI | What Happens | |--------|--------------| | "Create a /announce command" | Registers slash command | | "Set up a webhook for alerts" | Creates webhook | | "Schedule game night for Friday" | Creates event | | "Add trending emojis from emoji.gg" | Imports emojis |

📋 All 283 Tools

| Tool | Description | |------|-------------| | discord_get_bot_info | Bot user details, guild count, uptime, and ready status | | discord_get_gateway_info | Gateway ping, connection status, shard count | | discord_set_presence | Online/idle/dnd/invisible status | | discord_set_activity | Playing/streaming/listening/watching/custom activity | | discord_disconnect | Gracefully disconnect bot from gateway |

| Tool | Description | |------|-------------| | discord_send_dm | Send a private DM to a user | | discord_edit_dm | Edit a private DM | | discord_delete_dm | Delete a private DM | | discord_get_dms | Read DM message history with user |

| Tool | Description | |------|-------------| | get_allowed_guilds | List your authorized servers | | discord_list_guilds | List accessible servers | | discord_get_guild | Server details & features | | discord_edit_guild | Edit server settings & icons | | discord_get_server_stats | Comprehensive stats (humans, bots, voice active, channels, boost tier) | | discord_get_guild_preview | Get public preview of discoverable server | | discord_get_guild_regions | List voice RTC regions | | discord_get_guild_active_threads | List all active threads across server | | discord_edit_vanity_url | Modify vanity invite code | | discord_get_guild_incidents | Get raid alerts & incident state | | discord_edit_guild_incidents | Configure raid alerts & disable invites/DMs | | discord_get_member_safety_settings | Get verification & safety requirements | | discord_get_mfa_level | Get server 2FA/MFA moderation level | | discord_get_guild_nsfw_level | Get server NSFW classification | | discord_get_guild_channels | List channels | | discord_get_guild_roles | List roles | | discord_get_guild_emojis | List emojis | | discord_get_guild_stickers | List stickers | | discord_get_guild_invites | List invites | | discord_get_guild_webhooks | List webhooks | | discord_get_guild_bans | List bans | | discord_get_audit_log | Audit log | | discord_get_vanity_url | Vanity URL | | discord_leave_guild | Leave server | | discord_apply_template | Apply predefined template | | discord_get_guild_prune_count | Preview inactive member prune count | | discord_begin_guild_prune | Prune inactive members | | discord_get_guild_widget | Get server widget embed & settings | | discord_edit_guild_widget | Enable/disable widget & channel | | discord_get_guild_welcome_screen | Community welcome screen info | | discord_edit_guild_welcome_screen | Edit welcome screen & channels | | discord_get_guild_onboarding | Get community onboarding flow | | discord_edit_guild_onboarding | Edit onboarding questions & default channels | | discord_get_guild_integrations | List Twitch/YouTube/bot integrations | | discord_delete_guild_integration | Delete server integration |

| Tool | Description | |------|-------------| | discord_get_template | Get native template by code | | discord_list_guild_templates | List server's native templates | | discord_create_guild_template | Create template from server | | discord_sync_guild_template | Sync template with server layout | | discord_edit_guild_template | Edit template name & description | | discord_delete_guild_template | Delete server template | | discord_create_guild_from_template | Create new guild from template |

| Tool | Description | |------|-------------| | discord_create_channel | Create any channel type | | discord_edit_channel | Edit settings | | discord_delete_channel | Delete channel | | discord_clone_channel | Clone with settings | | discord_find_channel | Find channel by name & type | | discord_get_channel_info | Get channel details | | discord_move_channel | Move channel to category/position | | discord_lock_channel | Lock channel to prevent member messages | | discord_unlock_channel | Unlock a locked channel | | discord_set_slowmode | Set or remove channel slowmode delay | | discord_set_channel_topic | Update channel topic | | discord_modify_channel_positions | Reorder multiple channels | | discord_sync_channel_permissions | Sync permissions with parent category | | discord_create_voice_channel | Create voice channel | | discord_create_stage_channel | Create stage channel | | discord_edit_voice_channel | Edit voice/stage settings | | discord_get_voice_channel_members | List connected members in voice channel with audio/video status | | discord_get_guild_voice_states | Snapshot of all active voice channels & users in server | | discord_set_channel_permissions | Set permissions overwrite | | discord_list_channel_permissions | List channel overwrites | | discord_delete_channel_permissions | Delete channel overwrite | | discord_create_invite | Create invite link | | discord_delete_invite | Revoke invite link | | discord_get_invite_details | Get invite details & stats |

| Tool | Description | |------|-------------| | discord_create_category | Create new category | | discord_edit_category | Edit category name/position | | discord_delete_category | Delete category | | discord_find_category | Find category by name | | discord_list_channels_in_category | List category's channels |

| Tool | Description | |------|-------------| | discord_create_forum_channel | Create forum channel | | discord_edit_forum_channel | Edit forum settings/tags | | discord_list_forum_channels | List forum channels | | discord_get_forum_channel_info | Forum settings & tags | | discord_list_forum_tags | List available tags | | discord_list_forum_posts | List active posts | | discord_create_forum_post | Create forum post | | discord_modify_forum_post | Edit tags, pin/unpin, lock, archive forum post | | discord_create_thread | Create thread | | discord_get_thread | Get full thread metadata & counts | | discord_edit_thread | Edit thread | | discord_delete_thread | Delete thread | | discord_lock_thread | Lock thread to prevent new replies | | discord_unlock_thread | Unlock thread | | discord_archive_thread | Archive thread | | discord_unarchive_thread | Unarchive thread | | discord_get_active_threads | List active threads | | discord_list_archived_public_threads | List public archived threads | | discord_list_archived_private_threads | List private archived threads | | discord_list_joined_private_threads | List joined private archived threads | | discord_join_thread | Bot joins thread | | discord_leave_thread | Bot leaves thread | | discord_add_thread_member | Add user to thread | | discord_remove_thread_member | Remove user from thread | | discord_get_thread_member | Get user thread membership | | discord_list_thread_members | List all thread members |

| Tool | Description | |------|-------------| | discord_send_message | Send with embeds/buttons | | discord_send_embed | Rich embed | | discord_send_components_v2 | Components V2 | | discord_get_message | Fetch single message | | discord_reply_to_message | Referenced inline reply | | discord_send_typing | Trigger typing indicator | | discord_send_attachment | Upload files with message | | discord_download_attachment | Retrieve file attachment metadata & URL | | discord_forward_message | Forward message using snapshots | | discord_edit_message | Edit message | | discord_delete_message | Delete message | | discord_bulk_delete_messages | Bulk delete | | discord_get_messages | Fetch messages | | discord_search_messages | Search messages across channel or server with keyword & author filters | | discord_get_user_messages | Fetch last 100-500 messages sent by a specific user across channels | | discord_export_channel_transcript | Export full message transcript from channel | | discord_crosspost_message | Publish announcement message to follower channels | | discord_create_announcement_follower | Follow announcement channel to auto-receive posts | | discord_get_pinned_messages | Get all pinned messages in channel | | discord_pin_message | Pin message | | discord_unpin_message | Unpin message | | discord_get_reactions | Get users who reacted with emoji | | discord_add_reaction | Add reaction | | discord_remove_reaction | Remove reaction | | discord_clear_reaction_emoji | Clear all reactions for emoji | | discord_clear_all_reactions | Remove every reaction from message | | discord_create_poll | Create poll | | discord_end_poll | Immediately expire active poll | | discord_get_poll_voters | List voters for poll answer |

| Tool | Description | |------|-------------| | discord_get_user | Fetch global Discord user profile, avatar, banner | | discord_get_user_profile | Full profile: bio, custom status, rich presence games/Spotify, desktop/mobile status | | discord_edit_bot_profile | Edit bot username or avatar globally | | discord_get_current_member | Get bot's server member & permissions | | discord_edit_current_member | Change bot server nickname | | discord_get_member | Member info | | discord_search_members | Search members | | discord_list_members | List members | | discord_get_user_id_by_name | Get user ID for <@id> ping | | discord_get_member_roles | Get expanded role list for member | | discord_list_role_members | Find all members holding a role | | discord_get_member_avatar | Resolve server-specific avatar/banner | | discord_get_member_permissions_in_channel | Calculate channel effective permissions | | discord_kick_member | Kick | | discord_ban_member | Ban | | discord_bulk_ban_members | Native bulk ban multiple users | | discord_unban_member | Unban | | discord_timeout_member | Timeout | | discord_remove_timeout | Remove timeout | | discord_add_role | Add role | | discord_remove_role | Remove role | | discord_set_nickname | Set nickname | | discord_move_member_voice | Move to voice | | discord_disconnect_member | Disconnect from voice | | discord_server_mute_member | Server mute | | discord_server_deafen_member | Server deafen | | discord_modify_voice_state | Mute/deafen/suppress in voice |

| Tool | Description | |------|-------------| | discord_create_role | Create role | | discord_get_role | Get detailed role settings, permissions, icon | | discord_edit_role | Edit role | | discord_delete_role | Delete role | | discord_modify_single_role_position | Set single role position | | discord_modify_role_positions | Reorder role hierarchy | | discord_get_role_members | List members holding role | | discord_get_default_everyone_role | Get @everyone role & permissions | | discord_set_role_icon | Set role icon image | | discord_set_role_unicode_emoji | Set role emoji | | discord_get_member_permissions | Compute effective member permissions | | discord_list_permissions | List permissions |

| Tool | Description | |------|-------------| | discord_create_emoji | Create emoji | | discord_get_emoji_details | Emoji details & author | | discord_edit_emoji | Rename or role-restrict emoji | | discord_delete_emoji | Delete emoji | | discord_create_sticker | Create sticker | | discord_get_sticker | Get sticker details | | discord_edit_sticker | Edit sticker name/description/tags | | discord_delete_sticker | Delete sticker | | discord_search_emojigg | Search emoji.gg | | discord_add_emojigg | Add from emoji.gg |

| Tool | Description | |------|-------------| | discord_create_webhook | Create webhook | | discord_get_webhook | Get webhook details by ID | | discord_get_channel_webhooks | List all webhooks in channel | | discord_edit_webhook | Edit webhook name, avatar, or channel | | discord_delete_webhook | Delete webhook | | discord_execute_webhook | Send via webhook | | discord_execute_webhook_wait | Send webhook message & return created object | | discord_execute_webhook_in_thread | Send into thread or create forum post | | discord_execute_webhook_slack | Send Slack-compatible webhook payload | | discord_execute_webhook_github | Send GitHub-compatible webhook payload | | discord_get_webhook_message | Fetch webhook message | | discord_edit_webhook_message | Edit webhook message | | discord_delete_webhook_message | Delete webhook message |

| Tool | Description | |------|-------------| | discord_get_automod_rules | List rules | | discord_get_automod_rule | Get single rule details | | discord_create_automod_rule | Create rule | | discord_edit_automod_rule | Edit rule & filters | | discord_delete_automod_rule | Delete rule |

| Tool | Description | |------|-------------| | discord_get_stage_instance | Get active stage instance details | | discord_create_stage_instance | Start/open a stage instance with topic | | discord_edit_stage_instance | Edit active stage topic/privacy | | discord_delete_stage_instance | Close/end a stage instance |

| Tool | Description | |------|-------------| | discord_list_soundboard_sounds | List custom soundboard sounds | | discord_get_soundboard_sound | Get soundboard sound details | | discord_create_soundboard_sound | Upload custom soundboard audio | | discord_edit_soundboard_sound | Edit sound name/volume/emoji | | discord_delete_soundboard_sound | Delete soundboard sound | | discord_send_soundboard_sound | Play soundboard audio in voice channel | | discord_list_default_soundboard_sounds | List Discord default soundboard sounds |

| Tool | Description | |------|-------------| | discord_create_scheduled_event | Create event | | discord_get_scheduled_event | Fetch event details & interested user count | | discord_edit_scheduled_event | Edit event & status | | discord_get_scheduled_events | List events | | discord_get_scheduled_event_users | List interested users | | discord_delete_scheduled_event | Delete event |

| Tool | Description | |------|-------------| | discord_create_global_command | Create global command | | discord_get_global_command | Fetch single global command | | discord_get_global_commands | List global commands | | discord_edit_global_command | Edit global command | | discord_delete_global_command | Delete global command | | discord_bulk_overwrite_global_commands | Bulk overwrite all global commands | | discord_create_guild_command | Create guild command | | discord_get_guild_command | Fetch single guild command | | discord_get_guild_commands | List guild commands | | discord_edit_guild_command | Edit guild command | | discord_delete_guild_command | Delete guild command | | discord_bulk_overwrite_guild_commands | Bulk overwrite all guild commands | | discord_get_command_permissions | Get command permissions | | discord_edit_command_permissions | Set command permissions | | discord_batch_edit_command_permissions | Batch edit permissions for commands |

| Tool | Description | |------|-------------| | discord_reply_interaction | Reply to interaction | | discord_defer_interaction | Defer interaction ("thinking...") | | discord_edit_interaction_reply | Edit initial interaction reply | | discord_delete_interaction_reply | Delete initial interaction reply | | discord_send_interaction_followup | Send interaction follow-up | | discord_get_interaction_followup | Fetch interaction follow-up | | discord_edit_interaction_followup | Edit interaction follow-up | | discord_delete_interaction_followup | Delete interaction follow-up | | discord_reply_autocomplete | Respond to autocomplete suggestions | | discord_show_modal | Open modal popup | | discord_launch_activity | Create activity link in voice channel |

| Tool | Description | |------|-------------| | discord_subscribe_events | Subscribe to gateway events | | discord_unsubscribe_events | Unsubscribe from gateway events | | discord_list_event_subscriptions | List active event subscriptions | | discord_wait_for_event | Wait/poll until specific event occurs | | discord_get_recent_events | Query recent events buffer with filters | | discord_register_message_handler | Automated message handler | | discord_register_reaction_handler | Automated reaction handler | | discord_register_member_handler | Automated member join/leave handler | | discord_register_voice_handler | Automated voice state handler | | discord_register_thread_handler | Automated thread handler | | discord_register_interaction_handler | Automated interaction handler | | discord_unregister_handler | Remove automated handler |

| Tool | Description | |------|-------------| | discord_join_voice_channel | Connect bot to voice or stage channel (Opcode 4 Gateway WebRTC) | | discord_leave_voice_channel | Disconnect bot from active voice channel | | discord_get_bot_voice_state | Get bot voice state, active playback track, and volume | | discord_play_audio | Stream audio from YouTube, Spotify, SoundCloud, or direct URLs | | discord_play_audio_url | Stream direct audio URL (.mp3, .wav, .ogg, .aac, .mp4 stream) | | discord_play_local_audio | Play local sound file from disk into voice channel | | discord_speak_tts | Synthesize text to speech and speak in voice channel | | discord_pause_audio | Pause active audio playback | | discord_resume_audio | Resume paused audio playback | | discord_stop_audio | Stop audio playback and clear track | | discord_set_audio_volume | Adjust playback volume (0–200%) | | discord_start_voice_recording | Multi-track voice recording (all speakers + separate per-user tracks + user filters) | | discord_stop_voice_recording | Stop recording, finalize .opus files, and get duration & file size | | discord_list_voice_recordings | List saved voice channel audio recordings on disk |

| Tool | Description | |------|-------------| | db_query | SQL query on local SQLite | | db_execute | Execute SQL statement | | db_list_tables | List tables in DB | | db_get_schema | Get table schema | | discord_get_logs | Query action logs | | discord_get_guild_config | Get guild config | | discord_set_guild_config | Update guild config | | discord_get_db_stats | Database stats | | schedule_task | Schedule cron task | | list_scheduled_tasks | List scheduled tasks | | cancel_scheduled_task | Cancel scheduled task |

| Tool | Description | |------|-------------| | discord_resolve | Universal parser for URLs, mentions (<#id>, <@id>, <@&id>), IDs, and names into Discord entities | | discord_permission_check | Preflight check for bot permissions & role hierarchy before executing destructive actions | | discord_batch | Execute multiple independent MCP tool calls concurrently with per-operation results | | discord_get_api_capabilities | Inspect active Gateway intents, privileged flags, voice readiness, and REST API version | | discord_asset_to_data_uri | Convert web URLs or local images into Discord base64 Data URIs for emojis/stickers/icons | | discord_add_guild_member | Add OAuth2-authorized user to a server using their OAuth access token | | discord_api_call | Raw Discord REST API call (GET, POST, PATCH, PUT, DELETE) with query params & audit log reason |

🎙️ Live Voice Streaming & Multi-Track Audio Recording

Limitless Reign includes a full WebRTC Audio Pipeline (@discordjs/voice) allowing AI models to stream music, speak TTS, and record multi-user voice conversations with individual per-speaker tracks.

1. Connect & Stream Music / Audio

// 1. Join Voice Channel
{
  "tool": "discord_join_voice_channel",
  "arguments": {
    "guildId": "1532381127564857484",
    "channelId": "1537206459102666803"
  }
}

// 2. Stream YouTube, Spotify, or Direct MP3
{
  "tool": "discord_play_audio",
  "arguments": {
    "guildId": "1532381127564857484",
    "source": "https://www.youtube.com/watch?v=dQw4w9WgXcQ",
    "title": "Never Gonna Give You Up"
  }
}

// 3. Adjust Volume
{
  "tool": "discord_set_audio_volume",
  "arguments": {
    "guildId": "1532381127564857484",
    "volume": 75
  }
}

2. Pure In-Memory Multi-Track Recording (Zero Disk Required)

// Start Recording (buffered purely in memory with optional exclusion filters)
{
  "tool": "discord_start_voice_recording",
  "arguments": {
    "guildId": "1532381127564857484",
    "multiTrack": true,
    "excludedUserIds": ["123456789012345678"] // Ignore bots or noisy users
  }
}

// Stop Recording & optionally upload directly to a Discord text channel
{
  "tool": "discord_stop_voice_recording",
  "arguments": {
    "guildId": "1532381127564857484",
    "sendToChannelId": "1532381127564857486" // Optional: uploads in-memory buffer as Discord attachment message
  }
}

Response Output (In-Memory Base64 Data URIs & CDN Attachment):

{
  "success": true,
  "data": {
    "recording": {
      "id": "rec_1788029582",
      "durationSeconds": 45,
      "sizeBytes": 542100,
      "status": "completed",
      "attachmentUrl": "https://cdn.discordapp.com/attachments/.../rec_1788029582_recording.opus",
      "dataUri": "data:audio/ogg;codecs=opus;base64,T3B1c0hlYWQ...",
      "tracks": [
        {
          "name": "Master Combined Track (All Speakers)",
          "sizeBytes": 542100,
          "dataUri": "data:audio/ogg;codecs=opus;base64,..."
        },
        {
          "userId": "1136967689517142087",
          "name": "Speaker Track (User 1136967689517142087)",
          "sizeBytes": 271000,
          "dataUri": "data:audio/ogg;codecs=opus;base64,..."
        }
      ]
    }
  }
}

🔌 Connect Any AI

Claude Desktop

Edit claude_desktop_config.json:

Windows: %APPDATA%\Claude\claude_desktop_config.json
Mac: ~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "discord": {
      "url": "http://localhost:3000"
    }
  }
}

Claude Code

Install package and use the skill:

npm install limitless-reign-mcp

Then type /limitless-reign in Claude Code.

ChatGPT

Web Plugin: Settings → Security → Developer Mode → Plugins → Add:

http://localhost:3000/sse

Desktop: Settings → Integrations → Add MCP Server → Streamable HTTP:

http://localhost:3000

Cursor / Windsurf

Settings → Features → MCP → Add Server:

URL: http://localhost:3000

GPT Actions

Get OpenAPI schema:

GET http://localhost:3000?format=openapi

Paste in Custom GPT → Configure → Actions

💻 SDK Usage

Works with any backend framework. Just create the MCP server and mount it.

Core Setup (All Frameworks)

import { Client, GatewayIntentBits } from 'discord.js'
import { createMCPServer } from 'limitless-reign-mcp'

const client = new Client({
  intents: [GatewayIntentBits.Guilds, GatewayIntentBits.GuildMembers]
})

const mcp = createMCPServer({
  client,
  validateAccess: async (apiKey, guildId) => {
    // Your auth logic
    return { valid: true, userId: 'user-id' }
  },
  getAllowedGuilds: async (apiKey) => {
    return [{ id: '123', name: 'My Server', icon: null }]
  }
})

await client.login(process.env.DISCORD_TOKEN)

Express

import express from 'express'
import { expressMiddleware } from 'limitless-reign-mcp'

const app = express()
app.use(express.json())
app.use('/mcp', expressMiddleware(mcp))

app.listen(3000)

Next.js (App Router)

// lib/mcp.ts
import { createMCPServer } from 'limitless-reign-mcp'

let mcp: ReturnType<typeof createMCPServer>

export async function getMCP() {
  if (!mcp) {
    // ... setup client
    mcp = createMCPServer({ client, validateAccess, getAllowedGuilds })
  }
  return mcp
}

// app/api/mcp/route.ts
import { createNextjsRoute } from 'limitless-reign-mcp'
import { getMCP } from '@/lib/mcp'

export const { GET, POST, OPTIONS } = createNextjsRoute(getMCP)

// app/api/mcp/sse/route.ts
import { createNextjsSSERoute } from 'limitless-reign-mcp'
import { getMCP } from '@/lib/mcp'

export const { GET, POST, OPTIONS } = createNextjsSSERoute(getMCP)

Fastify

import Fastify from 'fastify'
import { handleHTTPRequest } from 'limitless-reign-mcp'

const app = Fastify()

app.all('/mcp', async (req, reply) => {
  const result = await handleHTTPRequest(mcp, {
    method: req.method,
    url: req.url,
    headers: req.headers as Record<string, string>,
    body: req.body,
    basePath: '/mcp'
  })
  reply.status(result.status).send(result.body)
})

app.listen({ port: 3000 })

Hono

import { Hono } from 'hono'
import { handleHTTPRequest } from 'limitless-reign-mcp'

const app = new Hono()

app.all('/mcp', async (c) => {
  const result = await handleHTTPRequest(mcp, {
    method: c.req.method,
    url: c.req.url,
    headers: Object.fromEntries(c.req.raw.headers),
    body: await c.req.json().catch(() => null),
    basePath: '/mcp'
  })
  return c.json(result.body, result.status)
})

export default app

Koa

import Koa from 'koa'
import Router from '@koa/router'
import bodyParser from 'koa-bodyparser'
import { handleHTTPRequest } from 'limitless-reign-mcp'

const app = new Koa()
const router = new Router()

router.all('/mcp', async (ctx) => {
  const result = await handleHTTPRequest(mcp, {
    method: ctx.method,
    url: ctx.href,
    headers: ctx.headers as Record<string, string>,
    body: ctx.request.body,
    basePath: '/mcp'
  })
  ctx.status = result.status
  ctx.body = result.body
})

app.use(bodyParser())
app.use(router.routes())
app.listen(3000)

Bun

import { handleHTTPRequest } from 'limitless-reign-mcp'

Bun.serve({
  port: 3000,
  async fetch(req) {
    const url = new URL(req.url)
    if (url.pathname.startsWith('/mcp')) {
      const result = await handleHTTPRequest(mcp, {
        method: req.method,
        url: req.url,
        headers: Object.fromEntries(req.headers),
        body: await req.json().catch(() => null),
        basePath: '/mcp'
      })
      return Response.json(result.body, { status: result.status })
    }
    return new Response('Not found', { status: 404 })
  }
})

Deno

import { handleHTTPRequest } from 'npm:limitless-reign-mcp'

Deno.serve({ port: 3000 }, async (req) => {
  const url = new URL(req.url)
  if (url.pathname.startsWith('/mcp')) {
    const result = await handleHTTPRequest(mcp, {
      method: req.method,
      url: req.url,
      headers: Object.fromEntries(req.headers),
      body: await req.json().catch(() => null),
      basePath: '/mcp'
    })
    return Response.json(result.body, { status: result.status })
  }
  return new Response('Not found', { status: 404 })
})

Node.js HTTP (No Framework)

import http from 'http'
import { handleHTTPRequest } from 'limitless-reign-mcp'

http.createServer(async (req, res) => {
  let body = ''
  for await (const chunk of req) body += chunk
  
  const result = await handleHTTPRequest(mcp, {
    method: req.method!,
    url: `http://localhost:3000${req.url}`,
    headers: req.headers as Record<string, string>,
    body: body ? JSON.parse(body) : null,
    basePath: '/mcp'
  })
  
  res.writeHead(result.status, { 'Content-Type': 'application/json' })
  res.end(JSON.stringify(result.body))
}).listen(3000)

🧩 Adding Custom & External Tools

Limitless Reign MCP is fully extensible. You can add custom tools, external HTTP REST APIs, bridge remote MCP servers, and write modular plugins using 6 different methods:

1. Server Configuration (`customTools` option)

Pass custom tools directly when creating your server:

import { createMCPServer } from 'limitless-reign-mcp'

const mcp = createMCPServer({
  client,
  validateAccess: async (key) => ({ valid: true }),
  customTools: [
    {
      name: 'calculate_stats',
      description: 'Compute server analytics score',
      inputSchema: {
        type: 'object',
        properties: {
          multiplier: { type: 'number', description: 'Score multiplier' }
        },
        required: ['multiplier']
      },
      handler: async (args, { client, database }) => {
        const memberCount = client.guilds.cache.reduce((acc, g) => acc + g.memberCount, 0)
        return { totalMembers: memberCount, score: memberCount * args.multiplier }
      }
    }
  ]
})

2. Runtime Registration (`mcp.registerTool` & `mcp.registerTools`)

import { defineTool } from 'limitless-reign-mcp'

// Register a single custom tool
mcp.registerTool(
  defineTool({
    name: 'custom_send_alert',
    description: 'Send high priority alert to moderator channel',
    inputSchema: {
      type: 'object',
      properties: {
        channelId: { type: 'string' },
        alertMessage: { type: 'string' }
      },
      required: ['channelId', 'alertMessage']
    },
    handler: async (args, { client }) => {
      const channel = await client.channels.fetch(args.channelId)
      if (channel?.isTextBased()) {
        await channel.send(`🚨 **ALERT:** ${args.alertMessage}`)
        return { success: true, delivered: true }
      }
      return { success: false, error: 'Channel is not text-based' }
    }
  })
)

// Check or unregister tools
mcp.hasTool('custom_send_alert') // true
mcp.unregisterTool('custom_send_alert')

3. External HTTP / REST API Tools (`createHttpTool`)

Turn any REST API endpoint or Webhook into an MCP tool with schema validation and authentication:

import { createHttpTool } from 'limitless-reign-mcp'

const weatherTool = createHttpTool({
  name: 'get_weather_report',
  description: 'Fetch current weather for a city',
  url: (args) => `https://api.weatherapi.com/v1/current.json?q=${encodeURIComponent(args.city)}&key=YOUR_API_KEY`,
  method: 'GET',
  inputSchema: {
    type: 'object',
    properties: {
      city: { type: 'string', description: 'City name' }
    },
    required: ['city']
  },
  transformResponse: (data) => ({
    city: data.location?.name,
    temp_c: data.current?.temp_c,
    condition: data.current?.condition?.text
  })
})

mcp.registerTool(weatherTool)

4. Bridge & Proxy External MCP Servers (`registerExternalMCP`)

Seamlessly connect remote MCP servers (such as GitHub MCP, Database MCP, or Web Search MCP) and merge their tools into your Discord MCP catalog:

// Proxy an external MCP server over HTTP/SSE
await mcp.registerExternalMCP({
  url: 'http://localhost:8080/mcp',
  prefix: 'ext_', // Optional prefix to avoid tool name clashes
  headers: {
    'Authorization': 'Bearer YOUR_REMOTE_TOKEN'
  },
  filterTools: (toolName) => !toolName.startsWith('dangerous_')
})

5. Modular Plugins (`mcp.use`)

Package and organize custom tools into reusable plugins:

import type { DiscordMCPServer } from 'limitless-reign-mcp'

function moderationPlugin(server: DiscordMCPServer) {
  server.registerTool({
    name: 'auto_quarantine_user',
    description: 'Move user to isolated quarantine role',
    inputSchema: {
      type: 'object',
      properties: {
        guildId: { type: 'string' },
        userId: { type: 'string' }
      },
      required: ['guildId', 'userId']
    },
    handler: async (args, { client }) => {
      // Your custom quarantine logic
      return { quarantined: true, userId: args.userId }
    }
  })
}

mcp.use(moderationPlugin)

6. CLI Dynamic Loading (`--tools`, `--plugin`, `--external-mcp`)

When using the standalone CLI, pass custom tools, plugins, or external MCP servers via command line flags or environment variables:

# Load custom tools file
npx limitless-reign --token YOUR_BOT_TOKEN --tools ./my-tools.js

# Load a plugin
npx limitless-reign --token YOUR_BOT_TOKEN --plugin ./my-plugin.js

# Proxy a remote MCP server
npx limitless-reign --token YOUR_BOT_TOKEN --external-mcp http://localhost:8000/mcp

🛡️ Access Control

Built-in permission system:

validateAccess: async (apiKey, guildId) => {
  const user = await db.users.findByApiKey(apiKey)
  
  if (!user) {
    return { valid: false, error: 'Invalid API key' }
  }
  
  if (guildId && !user.hasAccessTo(guildId)) {
    return { valid: false, error: 'No access to this server' }  
  }
  
  return { valid: true, userId: user.id }
}

📦 What's Included

| File | Purpose | |------|---------| | dist/cli.js | CLI - npx limitless-reign | | dist/index.js | SDK exports | | .claude/skills/ | Claude Code skill | | CLAUDE.md | AI instructions | | AGENTS.md | Agent documentation |

🔗 Links

GitHub: github.com/aayushchouhan24/limitless-reign-mcp
npm: npmjs.com/package/limitless-reign-mcp
Issues: Report bugs
Limitless Reign App: github.com/aayushchouhan24/limitless-reign-mcp

⭐ Star This Repo

If this helped you, give it a star! It helps others find it.

🌟 Author

🤝 Contributing

Contributions are welcome! Feel free to:

Fork the repository
Create a feature branch (git checkout -b feature/amazing-feature)
Commit your changes (git commit -m 'Add amazing feature')
Push to the branch (git push origin feature/amazing-feature)
Open a Pull Request