Omnicord MCP Server

Omnicord

Omnicord is an MCP server that gives your AI assistant full operational control of a Discord server. Day to day chat, moderation, administration, and at the top end: building out an entire community server from a one paragraph brief.

You describe what you want. Your AI decides how to do it. Omnicord makes sure it happens correctly, and that nothing destructive happens without your say so.

How it works

Your AI client (Claude Desktop, Cursor, Windsurf, Claude Code, or any other MCP client) is the brain. Omnicord is the hands: it talks to Discord through your own bot, enforces Discord's rules before they bite, queues politely behind rate limits, and gates every destructive action behind a preview you confirm. There is no LLM inside Omnicord and no cloud service behind it. Your bot token stays in a file on your machine.

Quick start

You need Node 20 or newer and a Discord account. One command:

npx @orygn/omnicord init

Or from source:

git clone https://github.com/OrygnsCode/Omnicord.git && cd Omnicord
npm install
npm run build
node dist/index.js init

The wizard goes from a bare Discord application to a working setup in about a minute. It takes the bot token with input hidden, verifies it live against Discord, checks the privileged intent toggles and waits while you fix any that are off, generates an invite link at the permission level you pick, saves the token to a gitignored .env, and writes the omnicord entry into your AI client's config (backing the file up first). Claude Desktop (including the Microsoft Store build), Cursor, Windsurf, and project level Claude Code are detected automatically; anything else gets a snippet to paste.

Then fully restart your AI client and ask it:

run a setup check on my Discord bot

Eight checks, plain English results, and the exact fix for anything that is wrong.

What it can do

The full contract for every tool is in the tool catalog.

The safety model

Destructive operations (deleting, banning, kicking, timeouts, bulk actions) never execute on the first call. They return a human readable preview and a confirmation token bound to that exact action; repeating the call with the token executes it. Tokens are single use and expire after two minutes. Moderation additionally preflights Discord's hierarchy rules, owner protection, and self protection before the gate, so the failure mode is an explanation rather than a 403.

This is enforced by Omnicord itself, not by the model's judgment. A confused or compromised AI session cannot skip the gate.

Running it

Stdio, the default, for desktop MCP clients:

node dist/index.js

Streamable HTTP, for remote capable clients and self hosting:

node dist/index.js --http              # 127.0.0.1:3414/mcp
node dist/index.js --http --port 8080

A bot token sits behind the HTTP endpoint, so the defaults are strict: binding beyond localhost without OMNICORD_HTTP_TOKEN refuses to start, bearer auth is compared in constant time, browser origins are rejected unless allowlisted, and the Host header is validated in loopback mode to close DNS rebinding. Details in self-hosting.

Docker

The image runs the HTTP transport as a non root user with the container health check wired to the health endpoint. It binds beyond loopback, so it requires OMNICORD_HTTP_TOKEN and exits with a clear message without one. The token never lives in the image; everything arrives through the environment at runtime.

docker build -t omnicord .
docker run -d -p 3414:3414 \
  -e DISCORD_TOKEN=your-bot-token \
  -e OMNICORD_HTTP_TOKEN=a-strong-secret \
  omnicord

Or with compose, after exporting the two secrets: docker compose up -d.

Configuration

Environment variables, or a .env file next to package.json:

Client config for stdio (Claude Desktop and compatible):

{
  "mcpServers": {
    "omnicord": {
      "command": "node",
      "args": ["/absolute/path/to/dist/index.js"]
    }
  }
}

No token goes in the client config; the server reads .env from its own package root regardless of what directory the client spawns it from.

Documentation

The docs are written to be read by AI assistants too: paste a page at your AI and have it walk you through.

Omnicord is also listed on the official MCP registry, Smithery, and Docker Hub.

Tests

node scripts/unit.mjs        # pure logic: resolver, permissions, planner, gate
node scripts/smoke.mjs       # stdio protocol session, no token needed
node scripts/smoke-http.mjs  # HTTP transport, sessions, auth, security gates
node scripts/acceptance.mjs  # live end-to-end against a real test server

The acceptance suite needs DISCORD_TOKEN and OMNICORD_GUILD pointing at a disposable test server, and cleans up after itself. scripts/smoke-docker.mjs builds and verifies the container image and needs a running Docker daemon.

License

Omnicord is source available under the Elastic License 2.0. In plain terms: anyone may read, use, modify, and self host it freely, including businesses running their own communities. The one thing the license forbids is offering Omnicord to third parties as a hosted or managed service. The code is public so it can be audited; it is not up for resale as a service.

Versioning

Semantic versioning, tracked in CHANGELOG.md. While the major version is 0 the tool surface may still shift between minor versions; 1.0.0 marks the public launch. The version in package.json flows everywhere automatically: the MCP server identity, the health endpoint, and the wizard.

Built by Orygn LLC. Security reports: security@orygn.tech.