Omnicord logo

Omnicord

by OrygnsCode

Manage Discord servers through MCP with messaging, moderation, diagnostics, and additive server building.

Install Omnicord

Pick your client, then add it in one click or paste the config.

STDIONode.js
~/Library/Application Support/Claude/claude_desktop_config.json
claude_desktop_config.json
{
  "mcpServers": {
    "orygnscode-omnicord": {
      "command": "npx",
      "args": [
        "-y",
        "@orygn/omnicord"
      ],
      "env": {
        "DISCORD_TOKEN": "YOUR_VALUE_HERE"
      }
    }
  }
}

Settings → Developer → Edit Config, merge this into mcpServers, then fully quit and reopen Claude Desktop.

Values are written into the snippet above so you can paste it as is. They never leave your browser.

Automated check passed— started and listed 155 tools correctly (1mo ago).

Overview

OrygnsCode/Omnicord MCP server gives AI clients operational control of Discord through a bot, including messaging, moderation, administration, diagnostics, and server construction. It runs locally with stdio or can expose a self-hosted streamable HTTP endpoint, while keeping the bot token in local configuration. Destructive actions return previews and require confirmation tokens before execution. Reach for it when an agent needs to inspect or manage Discord servers rather than only send individual messages.

Use cases

  • Inspect a Discord server's channels, roles, members, and bot health
  • Search message history across channels
  • Moderate and manage messages through confirmation-gated actions
  • Plan and build an additive community server from a blueprint
  • Configure multiple Discord bots for separate servers

Key features

  • Discord server administration over MCP
  • Message and member search
  • Confirmation-gated destructive actions
  • Blueprint-based additive server building
  • Bot setup and rate-limit diagnostics
  • stdio and self-hosted HTTP transports

Tools155

What Omnicord lets your agent do. Expand a tool for its parameters.

Verified live~26.9k tokens of context

Security & health

What it can reach and how reliably it runs — from our own checks, not the maintainer’s claims.

ActiveLast checked 2d ago

Recent health check succeeded.

96/96 checks healthy over the last 60d

Supply-chain signal

No high-severity advisories surfaced by our automated scan.

Critical 0High 0Medium 0Low 0

Scanned 8d ago via OSV.dev · @orygn/omnicord (npm)

Adoption & maintenance

Factual signals from GitHub, npm, and our automated checks — not a rating.

GitHub stars9Stargazers on the source repository.
npm downloads854Package downloads in the last 30 days.
Last commit11d agoMost recent push to the default branch.
Availability100%Our rolling endpoint + install checks that succeeded.
Install checkPassedOur sandbox started it and listed its tools.
Tools exposed155Callable tools this server registers over MCP.
Directory activity10 viewsConfig copies, upvotes, and views on AllMCPs.

How Omnicord works

What OrygnsCode/Omnicord MCP server does

OrygnsCode/Omnicord MCP server connects an MCP client to Discord through a bot that you control. It covers routine server operations such as reading channel history, searching messages, resolving members and roles, sending messages, managing channels and roles, and checking bot health.

The server can also help create a community structure from a blueprint. Reference layouts provide starting points, while planning validates names, limits, dependencies, features, and bot permissions before changing anything. Execution is additive: matching channels and roles are reused, and existing entities are not deleted or modified by a build.

How it works

An AI client supplies the reasoning, and Omnicord performs Discord API operations through the configured bot. It does not contain its own language model or depend on a hosted cloud service. The default transport is stdio for desktop clients. Streamable HTTP is also available for self-hosting, with configurable binding, port, bearer authentication, and browser-origin restrictions.

Safety checks are part of the server. Delete operations first return a readable preview and a short-lived confirmation token; the action runs only when the same request is repeated with that token. Rate-limit handling waits when Discord asks the client to slow down, and setup diagnostics report token, intent, guild, and membership problems with repair guidance.

Setup and configuration

OrygnsCode/Omnicord MCP server requires Node.js 20 or newer and a Discord account. The documented setup command is npx @orygn/omnicord init; the wizard accepts the bot token, verifies it, checks privileged intents, creates an invite, stores local configuration, and can add the MCP entry to detected client configuration files. Claude Desktop, Cursor, Windsurf, and project-level Claude Code are detected automatically. Other MCP clients receive a configuration snippet.

For a source checkout, the documented sequence is to clone the repository, run npm install, run npm run build, and start node dist/index.js. The bot token is provided through DISCORD_TOKEN, with optional defaults and behavior controlled by variables such as OMNICORD_GUILD, OMNICORD_TOOLS, OMNICORD_SAFE_MODE, and OMNICORD_GATEWAY. Multiple bots can be configured in bots.json; each can serve a different Discord server.

Tools and capabilities

The supplied catalog supports:

  • Inspecting bot identity, gateway intents, guild count, rate limits, server structure, channels, roles, members, messages, and pins.
  • Searching message history and members, resolving names to IDs, and reading detailed member profiles.
  • Sending, forwarding, editing, pinning, and unpinning messages, including replies and embeds; other documented capabilities include DMs, webhooks, reactions, polls, and scheduled messages.
  • Creating, updating, and deleting channels and roles, assigning roles, and setting voice-channel status.
  • Planning and executing additive server builds from blueprints, with validation and resumable execution.
  • Running setup checks before diagnosing a misconfigured bot.

Limitations and notes

The bot can act only where Discord grants it access and permissions. Message search covers channels the bot can read, and role-based member searches may report when a paging cap is reached. Discord does not allow the bot to edit messages sent by other users. Channel pinning requires the Pin Messages permission and is subject to Discord's 50-pin limit.

HTTP mode needs additional protection when exposed beyond localhost: the README requires OMNICORD_HTTP_TOKEN for non-loopback binding. The default safe mode previews destructive actions; disabling that behavior is available through configuration but is intended only for trusted automation. OrygnsCode/Omnicord MCP server is therefore best suited to deployments where the bot permissions, token storage, and confirmation flow can be controlled.

Reviews

No reviews yet — be the first to share how it worked for you.

Frequently Asked Questions about Omnicord

Use Node.js 20 or newer and run the documented setup command `npx @orygn/omnicord init`. The wizard configures the bot and can write client settings.

Yes. Claude Desktop is detected automatically by the setup wizard, including the Microsoft Store build.

It uses a Discord bot token supplied through `DISCORD_TOKEN` or local environment configuration. The setup wizard verifies the token against Discord.

Deletion tools preview the action first and return a confirmation token. The deletion runs only when the request is repeated with that token.

Yes. It can validate and execute a blueprint containing roles, categories, channels, and permission settings, using existing matching entities instead of duplicating them.

Related MCP servers

Add a badge to your READMEShow it’s listed — live SVG, Markdown or HTML.

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:
Live Dynamic SVG PreviewOmnicord AllMCPs Directory Badge
Markdown (GitHub README)
[![AllMCPs](https://allmcps.com/api/badge/orygnscode-omnicord?style=directory)](https://allmcps.com/mcp/orygnscode-omnicord)
HTML Embed
<a href="https://allmcps.com/mcp/orygnscode-omnicord"><img src="https://allmcps.com/api/badge/orygnscode-omnicord?style=directory" alt="Omnicord on AllMCPs" /></a>