Discord MCP Server for Mastra AI 10 tools — connect in under 2 minutes
Mastra AI is a TypeScript-native agent framework built for modern web stacks. Connect Discord through the Vinkius and Mastra agents discover all tools automatically — type-safe, streaming-ready, and deployable anywhere Node.js runs.
ASK AI ABOUT THIS MCP SERVER
Vinkius supports streamable HTTP and SSE.
import { Agent } from "@mastra/core/agent";
import { createMCPClient } from "@mastra/mcp";
import { openai } from "@ai-sdk/openai";
async function main() {
// Your Vinkius token — get it at cloud.vinkius.com
const mcpClient = await createMCPClient({
servers: {
"discord": {
url: "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp",
},
},
});
const tools = await mcpClient.getTools();
const agent = new Agent({
name: "Discord Agent",
instructions:
"You help users interact with Discord " +
"using 10 tools.",
model: openai("gpt-4o"),
tools,
});
const result = await agent.generate(
"What can I do with Discord?"
);
console.log(result.text);
}
main();
* Every MCP server runs on Vinkius-managed infrastructure inside AWS - a purpose-built runtime with per-request V8 isolates, Ed25519 signed audit chains, and sub-40ms cold starts optimized for native MCP execution. See our infrastructure
About Discord MCP Server
Connect your Discord bot to any AI agent and take full control of your community management and real-time messaging through natural conversation.
Mastra's agent abstraction provides a clean separation between LLM logic and Discord tool infrastructure. Connect 10 tools through the Vinkius and use Mastra's built-in workflow engine to chain tool calls with conditional logic, retries, and parallel execution — deployable to any Node.js host in one command.
What you can do
- Server & Guild Auditing — Perform structural extraction of metadata linked to a Discord Server, fetching member approximations and Snowflake IDs
- Channel Orchestration — Identify explicitly assigned routing text/voice channels and manage parent-category mappings to organize your server logically
- Messaging & Chat — Dispatch automated text payloads with Markdown support and edit pre-existing textual strings to update dynamic information in real-time
- Member Oversight — Enumerate explicitly attached user accounts and iterate through authorized members matching your server namespace
- Content Moderation — Forcibly purge chat payloads out of visible memory and irreversibly delete active channel mappings to manage server security
- Real-time Logs — Pull chronological asynchronous logs from any channel, extracting string contents and nested attachment metadata
- Slowmode Control — Inspect deep properties identifying precise rate-limit configurations and evaluate assigned delays natively
The Discord MCP Server exposes 10 tools through the Vinkius. Connect it to Mastra AI in under two minutes — no API keys to rotate, no infrastructure to provision, no vendor lock-in. Your configuration, your data, your control.
How to Connect Discord to Mastra AI via MCP
Follow these steps to integrate the Discord MCP Server with Mastra AI.
Install dependencies
Run npm install @mastra/core @mastra/mcp @ai-sdk/openai
Replace the token
Replace [YOUR_TOKEN_HERE] with your Vinkius token
Run the agent
Save to agent.ts and run with npx tsx agent.ts
Explore tools
Mastra discovers 10 tools from Discord via MCP
Why Use Mastra AI with the Discord MCP Server
Mastra AI provides unique advantages when paired with Discord through the Model Context Protocol.
Mastra's agent abstraction provides a clean separation between LLM logic and tool infrastructure — add Discord without touching business code
Built-in workflow engine chains MCP tool calls with conditional logic, retries, and parallel execution for complex automation
TypeScript-native: full type inference for every Discord tool response with IDE autocomplete and compile-time checks
One-command deployment to any Node.js host — Vercel, Railway, Fly.io, or your own infrastructure
Discord + Mastra AI Use Cases
Practical scenarios where Mastra AI combined with the Discord MCP Server delivers measurable value.
Automated workflows: build multi-step agents that query Discord, process results, and trigger downstream actions in a typed pipeline
SaaS integrations: embed Discord as a first-class tool in your product's AI features with Mastra's clean agent API
Background jobs: schedule Mastra agents to query Discord on a cron and store results in your database automatically
Multi-agent systems: create specialist agents that collaborate using Discord tools alongside other MCP servers
Discord MCP Tools for Mastra AI (10)
These 10 tools become available when you connect Discord to Mastra AI via MCP:
create_guild_channel
Default `type=0` maps to standard Text Channels. Provision a radically fast new structural Channel sandbox
create_message
Capable of mapping Markdown `<@user_id>` tags natively forcing push notifications instantly. Dispatch an automated text Payload resolving towards a Channel
delete_channel
Vaporizes all nested historical chat payloads, pinned messages, and file attachments natively dropping active connections entirely returning 404s. Irreversibly delete an entirely active Discord Channel mapping
delete_message
Drops the raw chat out of the Channel history permanently replacing it with visual space on all clients natively. Purge an existing Chat Payload out of the visible memory
edit_message
Ideal for updating dynamic progress bars inside a live Chat context. Mutate pre-existing textual strings tied to a Bot Message
get_channel
Inspect deep properties identifying a precise Discord Channel
get_guild
Fetches explicit Snowflake IDs configuring precisely the total member approximations natively bypassing localized channel scopes. Perform structural extraction of metadata linked to a Discord Server
list_channel_messages
Extracts string contents, nested attachments mapping binary sizes, and embed payloads. Read recent structural Chat payloads targeting a Channel
list_guild_channels
Returns crucial Snowflake Channel IDs prerequisite to performing all downstream messaging actions. Identify explicitly assigned routing text/voice Channels within a Server
list_guild_members
Restricted heavily by `GUILD_MEMBERS` Privileged Intent inside the developer portal securely. Enumerate explicitly attached user accounts active within the Server
Example Prompts for Discord in Mastra AI
Ready-to-use prompts you can give your Mastra AI agent to start working with Discord immediately.
"List all channels in guild '123456789'"
"Send a message to channel '101': 'Hello community! The bot is live.'"
"Get the last 5 messages from channel '101'"
Troubleshooting Discord MCP Server with Mastra AI
Common issues when connecting Discord to Mastra AI through the Vinkius, and how to resolve them.
createMCPClient not exported
npm install @mastra/mcpDiscord + Mastra AI FAQ
Common questions about integrating Discord MCP Server with Mastra AI.
How does Mastra AI connect to MCP servers?
MCPClient with the server URL and pass it to your agent. Mastra discovers all tools and makes them available with full TypeScript types.Can Mastra agents use tools from multiple servers?
Does Mastra support workflow orchestration?
Connect Discord with your favorite client
Step-by-step setup guides for every MCP-compatible client and framework:
Anthropic's native desktop app for Claude with built-in MCP support.
AI-first code editor with integrated LLM-powered coding assistance.
GitHub Copilot in VS Code with Agent mode and MCP support.
Purpose-built IDE for agentic AI coding workflows.
Autonomous AI coding agent that runs inside VS Code.
Anthropic's agentic CLI for terminal-first development.
Python SDK for building production-grade OpenAI agent workflows.
Google's framework for building production AI agents.
Type-safe agent development for Python with first-class MCP support.
TypeScript toolkit for building AI-powered web applications.
TypeScript-native agent framework for modern web stacks.
Python framework for orchestrating collaborative AI agent crews.
Leading Python framework for composable LLM applications.
Data-aware AI agent framework for structured and unstructured sources.
Microsoft's framework for multi-agent collaborative conversations.
Connect Discord to Mastra AI
Get your token, paste the configuration, and start using 10 tools in under 2 minutes. No API key management needed.
