feat: Add Discord MCP integration and improve README by YaSh8202 · Pull Request #46 · YaSh8202/remote-mcp

YaSh8202 · 2025-12-10T08:13:18Z

🚀 Features

Discord MCP Integration

Complete Discord MCP app with OAuth2 authentication following the existing app pattern
6 Discord tools for comprehensive Discord management:
- get_user_info - Get current authenticated user information
- list_guilds - List user's Discord servers
- list_channels - List channels in a Discord server
- send_message - Send messages to Discord channels
- get_messages - Retrieve messages from Discord channels
- add_reaction - Add emoji reactions to messages
Proper TypeScript types for Discord API with comprehensive interface definitions
OAuth2 authentication with appropriate Discord scopes (bot, messages.read, guilds, etc.)
Error handling and proper API response formatting

README Improvements

✅ Added Discord integration to Available Apps section
✅ Updated tool count from 159+ to 165+ tools across 12 applications
✅ Improved wording for better user experience ("Easily create" vs "Create")
✅ Enhanced Getting Started section with friendlier language
✅ Added Discord examples to use cases section
✅ Fixed LICENSE file link with proper relative path
✅ Verified all section links work correctly
✅ No typos found - ran comprehensive typo check

🔧 Technical Details

Discord App Structure

src/app/mcp/apps/discord/
├── index.ts           # Main Discord MCP app definition
├── common.ts          # OAuth2 configuration
├── discord-client.ts  # Discord API client with typed methods
├── types.ts           # Comprehensive Discord API TypeScript types
└── tools/
    ├── index.ts       # Tool exports
    ├── get-user-info.ts
    ├── list-guilds.ts
    ├── list-channels.ts
    ├── send-message.ts
    ├── get-messages.ts
    └── add-reaction.ts

Code Quality

✅ All TypeScript checks pass - no any types used
✅ Biome formatting applied - consistent code style
✅ Build successful - verified with pnpm run build
✅ Follows existing patterns - consistent with Slack/GitHub apps

🧪 Testing

✅ TypeScript compilation successful
✅ Biome linting and formatting passed
✅ Build process completed without errors
✅ All imports and exports properly configured

📝 Documentation

The Discord integration is now fully documented in the README with:

App description and tool count
Example use cases
Updated navigation links
Improved user-friendly language

🎯 Impact

This PR adds Discord as the 12th integrated application, bringing the total to 165+ tools and expanding communication capabilities for MCP users. The README improvements make the project more welcoming and easier to understand for new users.

@YaSh8202 can click here to continue refining the PR

- Add comprehensive Discord MCP app with OAuth2 authentication - Implement 6 Discord tools: send messages, list guilds/channels, get messages, add reactions, get user info - Add proper TypeScript types for Discord API - Update README with Discord integration documentation - Improve README wording for better user experience - Update tool count to 165+ tools across 12 applications - Add Discord to example use cases - Fix LICENSE file link in README Co-authored-by: openhands <openhands@all-hands.dev>

vercel · 2025-12-10T08:13:23Z

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Preview	Comments	Updated (UTC)
mcp-one	Ready	Preview	Comment	Dec 10, 2025 8:14am

Copilot

Pull request overview

This PR adds Discord as a new MCP integration with 6 tools for managing Discord servers, channels, and messages through OAuth2 authentication. The implementation follows existing app patterns (similar to Slack and GitHub integrations) and updates documentation to reflect the new integration, bringing the total from 159 to 165 tools across 12 applications.

Key changes:

Complete Discord MCP app with 6 tools (user info, guilds, channels, messages, reactions)
Comprehensive TypeScript types for Discord API entities
OAuth2 authentication flow with Discord
Updated README with Discord documentation and improved wording

Reviewed changes

Copilot reviewed 13 out of 13 changed files in this pull request and generated 16 comments.

Show a summary per file

File	Description
`src/app/mcp/apps/index.ts`	Registers Discord app in the MCP apps array
`src/app/mcp/apps/discord/index.ts`	Main Discord app definition with metadata and logo
`src/app/mcp/apps/discord/common.ts`	OAuth2 authentication configuration with Discord API endpoints
`src/app/mcp/apps/discord/discord-client.ts`	Discord API client with typed methods for user, guild, channel, and message operations
`src/app/mcp/apps/discord/types.ts`	Comprehensive TypeScript interface definitions for Discord API entities
`src/app/mcp/apps/discord/tools/index.ts`	Exports all 6 Discord tools
`src/app/mcp/apps/discord/tools/get-user-info.ts`	Tool to fetch authenticated user information
`src/app/mcp/apps/discord/tools/list-guilds.ts`	Tool to list user's Discord servers
`src/app/mcp/apps/discord/tools/list-channels.ts`	Tool to list channels in a guild with type categorization
`src/app/mcp/apps/discord/tools/send-message.ts`	Tool to send messages with embed support
`src/app/mcp/apps/discord/tools/get-messages.ts`	Tool to retrieve messages with pagination
`src/app/mcp/apps/discord/tools/add-reaction.ts`	Tool to add emoji reactions to messages
`README.md`	Updates Available Apps section with Discord, improves wording (em-dashes, friendlier language), fixes LICENSE link, adds Discord use case examples, and updates tool count to 165+

Copilot · 2025-12-10T08:19:36Z

src/app/mcp/apps/discord/tools/get-messages.ts

@@ -0,0 +1,89 @@
+import { createParameterizedTool } from "@/app/mcp/mcp-app/tools";
+import { z } from "zod";


Import statement should use zod/v4 instead of zod for consistency with the codebase convention. Change to:

import { z } from "zod/v4";

Copilot · 2025-12-10T08:19:37Z

src/app/mcp/apps/discord/tools/get-user-info.ts

+			return {
+				content: [
+					{
+						type: "text" as const,
+						text: formatDiscordError(error),
+					},
+				],
+			};


Error response should include isError: true flag to follow the codebase convention for tool error handling. Update to:

return { content: [ { type: "text" as const, text: formatDiscordError(error), }, ], isError: true, };

Copilot · 2025-12-10T08:19:37Z

src/app/mcp/apps/discord/tools/send-message.ts

+			return {
+				content: [
+					{
+						type: "text" as const,
+						text: formatDiscordError(error),
+					},
+				],
+			};


Error response should include isError: true flag to follow the codebase convention for tool error handling. Update to:

return { content: [ { type: "text" as const, text: formatDiscordError(error), }, ], isError: true, };

Copilot · 2025-12-10T08:19:37Z

src/app/mcp/apps/discord/tools/get-user-info.ts

@@ -0,0 +1,58 @@
+import { createParameterizedTool } from "@/app/mcp/mcp-app/tools";
+import { z } from "zod";


Import statement should use zod/v4 instead of zod for consistency with the codebase convention. Change to:

import { z } from "zod/v4";

Copilot · 2025-12-10T08:19:38Z

src/app/mcp/apps/discord/tools/list-channels.ts

@@ -0,0 +1,70 @@
+import { createParameterizedTool } from "@/app/mcp/mcp-app/tools";
+import { z } from "zod";


Import statement should use zod/v4 instead of zod for consistency with the codebase convention. Change to:

import { z } from "zod/v4";

Copilot · 2025-12-10T08:19:40Z

src/app/mcp/apps/discord/tools/list-guilds.ts

+			return {
+				content: [
+					{
+						type: "text" as const,
+						text: formatDiscordError(error),
+					},
+				],
+			};


Error response should include isError: true flag to follow the codebase convention for tool error handling. Update to:

return { content: [ { type: "text" as const, text: formatDiscordError(error), }, ], isError: true, };

Copilot · 2025-12-10T08:19:40Z

src/app/mcp/apps/discord/discord-client.ts

+			const errorText = await response.text();
+			throw new Error(`Discord API Error (${response.status}): ${errorText}`);
+		}
+


The makeRequest method will fail for Discord API endpoints that return 204 No Content responses (such as adding/removing reactions). When the response status is 204, there is no body to parse, so response.json() will throw an error.

Update the method to handle empty responses:

if (!response.ok) { const errorText = await response.text(); throw new Error(`Discord API Error (${response.status}): ${errorText}`); } // Handle 204 No Content or other empty responses if (response.status === 204 || response.headers.get('content-length') === '0') { return undefined as T; } return response.json();

This affects the addReaction and removeReaction methods which use PUT and DELETE endpoints that return 204.

Suggested change

// Handle 204 No Content or other empty responses

if (response.status === 204 || response.headers.get("content-length") === "0") {

return undefined as T;

}

Copilot · 2025-12-10T08:19:40Z

src/app/mcp/apps/discord/tools/list-guilds.ts

@@ -0,0 +1,49 @@
+import { createParameterizedTool } from "@/app/mcp/mcp-app/tools";
+import { z } from "zod";


Import statement should use zod/v4 instead of zod for consistency with the codebase convention. Change to:

import { z } from "zod/v4";

Copilot · 2025-12-10T08:19:40Z

src/app/mcp/apps/discord/tools/get-user-info.ts

@@ -0,0 +1,58 @@
+import { createParameterizedTool } from "@/app/mcp/mcp-app/tools";
+import { z } from "zod";


Unused import z.

Suggested change

import { z } from "zod";

Copilot · 2025-12-10T08:19:41Z

src/app/mcp/apps/discord/tools/list-guilds.ts

@@ -0,0 +1,49 @@
+import { createParameterizedTool } from "@/app/mcp/mcp-app/tools";
+import { z } from "zod";


Unused import z.

Suggested change

import { z } from "zod";

Copilot AI review requested due to automatic review settings December 10, 2025 08:13

Copilot started reviewing on behalf of YaSh8202 December 10, 2025 08:13 View session

vercel bot deployed to Preview December 10, 2025 08:14 View deployment

Copilot AI reviewed Dec 10, 2025

View reviewed changes

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

feat: Add Discord MCP integration and improve README#46

feat: Add Discord MCP integration and improve README#46
YaSh8202 wants to merge 1 commit intomainfrom
feat/discord-integration-and-readme-improvements

YaSh8202 commented Dec 10, 2025

Uh oh!

vercel bot commented Dec 10, 2025 •

edited

Loading

Uh oh!

Copilot AI left a comment

Uh oh!

Copilot AI Dec 10, 2025

Uh oh!

Copilot AI Dec 10, 2025

Uh oh!

Copilot AI Dec 10, 2025

Uh oh!

Copilot AI Dec 10, 2025

Uh oh!

Copilot AI Dec 10, 2025

Uh oh!

Copilot AI Dec 10, 2025

Uh oh!

Copilot AI Dec 10, 2025

Uh oh!

Copilot AI Dec 10, 2025

Uh oh!

Copilot AI Dec 10, 2025

Uh oh!

Copilot AI Dec 10, 2025

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

3 participants

		@@ -0,0 +1,89 @@
		import { createParameterizedTool } from "@/app/mcp/mcp-app/tools";
		import { z } from "zod";

		@@ -0,0 +1,58 @@
		import { createParameterizedTool } from "@/app/mcp/mcp-app/tools";
		import { z } from "zod";

		@@ -0,0 +1,70 @@
		import { createParameterizedTool } from "@/app/mcp/mcp-app/tools";
		import { z } from "zod";

+		// Handle 204 No Content or other empty responses
+		if (response.status === 204 || response.headers.get("content-length") === "0") {
+			return undefined as T;
+		}

		@@ -0,0 +1,49 @@
		import { createParameterizedTool } from "@/app/mcp/mcp-app/tools";
		import { z } from "zod";

Conversation

YaSh8202 commented Dec 10, 2025

🚀 Features

Discord MCP Integration

README Improvements

🔧 Technical Details

Discord App Structure

Code Quality

🧪 Testing

📝 Documentation

🎯 Impact

Uh oh!

vercel bot commented Dec 10, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull request overview

Reviewed changes

Uh oh!

Copilot AI Dec 10, 2025

Choose a reason for hiding this comment

Uh oh!

Copilot AI Dec 10, 2025

Choose a reason for hiding this comment

Uh oh!

Copilot AI Dec 10, 2025

Choose a reason for hiding this comment

Uh oh!

Copilot AI Dec 10, 2025

Choose a reason for hiding this comment

Uh oh!

Copilot AI Dec 10, 2025

Choose a reason for hiding this comment

Uh oh!

Copilot AI Dec 10, 2025

Choose a reason for hiding this comment

Uh oh!

Copilot AI Dec 10, 2025

Choose a reason for hiding this comment

Uh oh!

Copilot AI Dec 10, 2025

Choose a reason for hiding this comment

Uh oh!

Copilot AI Dec 10, 2025

Choose a reason for hiding this comment

Uh oh!

Copilot AI Dec 10, 2025

Choose a reason for hiding this comment

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

3 participants

vercel bot commented Dec 10, 2025 •

edited

Loading