# omnicord

Controls Discord servers via local bot automation: manages moderation, drafts channel layouts, and runs administrative checks.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 9
- Author: OrygnsCode
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/OrygnsCode/Omnicord
- Updated: 2026-10-17
- HTML: https://affpapa.org/en/nevibecode/mcp/omnicord

## What it does

Omnicord connects your development client to the Discord API using your own bot token over stdio or HTTP transports. The tool gives your assistant capacity to post updates, query chat history, and build server hierarchies from text outlines. There is no background cloud backend or separate LLM: the host model decides the plan, while Omnicord queues API calls and handles rate limits.

Destructive changes like kicking members, banning, or pruning channels require explicit verification. Omnicord halts dangerous commands by returning an action summary along with a single-use token valid for two minutes. A second request with that exact token is mandatory to execute the modification.

Running the package requires Node 20 or newer and a configured Discord bot token. Exposing the HTTP listener beyond loopback fails immediately unless you specify an authorization secret in `OMNICORD_HTTP_TOKEN`.

## Requirements
- Needs: Node.js (commands run via npx)
- Environment variables: `DISCORD_TOKEN`, `OMNICORD_GUILD` — keys and tokens: ask the human for the values, never commit them or put them in shared files.

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add --env DISCORD_TOKEN=<DISCORD_TOKEN> --env OMNICORD_GUILD=<OMNICORD_GUILD> --transport stdio omnicord -- npx -y @orygn/omnicord
```
Replace <…> with your own values

### Codex

**Platform CLI**
```bash
codex mcp add omnicord --env DISCORD_TOKEN=<DISCORD_TOKEN> --env OMNICORD_GUILD=<OMNICORD_GUILD> -- npx -y @orygn/omnicord
```
Replace <…> with your own values

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "omnicord": {
            "command": "npx",
            "args": [
                "-y",
                "@orygn/omnicord"
            ],
            "env": {
                "DISCORD_TOKEN": "<DISCORD_TOKEN>",
                "OMNICORD_GUILD": "<OMNICORD_GUILD>"
            }
        }
    }
}
```
Replace <…> with your own values

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "omnicord": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "@orygn/omnicord"
            ],
            "env": {
                "DISCORD_TOKEN": "<DISCORD_TOKEN>",
                "OMNICORD_GUILD": "<OMNICORD_GUILD>"
            }
        }
    }
}
```
Replace <…> with your own values

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add -e DISCORD_TOKEN=<DISCORD_TOKEN> -e OMNICORD_GUILD=<OMNICORD_GUILD> omnicord npx -y @orygn/omnicord
```
Replace <…> with your own values

## When to use it
- Provision channels, categories, and permission overwrites from a short brief
- Moderate communities using timeouts, kicks, and preview-gated bans
- Configure AutoMod rules to restrict spam and unwanted keywords
- Inspect server audit logs and message history

## Example prompts
- Run a setup check on my Discord bot
- Draft a category structure with text and voice channels for our engineering group
- Search the `#announcements` channel for mentions of the upcoming release

## Similar
- [REA](https://affpapa.org/en/nevibecode/mcp/rea.md) — MCP server · ★ 392262
- [GitHub](https://affpapa.org/en/nevibecode/mcp/github.md) — MCP server · ★ 33989
- [Netdata](https://affpapa.org/en/nevibecode/mcp/netdata.md) — MCP server · ★ 81163
- [browser-use](https://affpapa.org/en/nevibecode/mcp/browser-use.md) — MCP server · ★ 119231
- [Codebase Memory](https://affpapa.org/en/nevibecode/mcp/codebase-memory.md) — MCP server · ★ 47577
- [mcp-server](https://affpapa.org/en/nevibecode/mcp/mcp-server.md) — MCP server · ★ 43902

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md