Accord Server MCP

MCP (Model Context Protocol) server integration for connecting AI agents to an Accord chat server instance. Includes client configuration for major AI coding tools and a standalone CLI client.

Prerequisites

• An Accord server running with MCP_API_KEY set
• The server's base URL (e.g. http://localhost:39099)

Agent Setup

Accord exposes a streamable HTTP MCP endpoint at /mcp. The examples below assume your server is at http://localhost:39099 -- replace with your actual URL and API key.

Claude Code

Add a .mcp.json file to your project root (or ~/.claude/.mcp.json for global config):

{
  "mcpServers": {
    "accord": {
      "type": "streamable-http",
      "url": "http://localhost:39099/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_MCP_API_KEY"
      }
    }
  }
}

Or add it interactively:

claude mcp add accord --transport http http://localhost:39099/mcp \
  -H "Authorization: Bearer YOUR_MCP_API_KEY"

Codex (OpenAI)

Create or edit codex.json in your project root (or ~/.codex/codex.json for global):

{
  "mcpServers": {
    "accord": {
      "type": "streamable-http",
      "url": "http://localhost:39099/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_MCP_API_KEY"
      }
    }
  }
}

OpenCode

Add to your opencode.json (project root or ~/.config/opencode/config.json):

{
  "mcp": {
    "accord": {
      "type": "streamable-http",
      "url": "http://localhost:39099/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_MCP_API_KEY"
      }
    }
  }
}

Claude Desktop

Add to ~/.claude/claude_desktop_config.json:

{
  "mcpServers": {
    "accord": {
      "type": "streamable-http",
      "url": "http://localhost:39099/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_MCP_API_KEY"
      }
    }
  }
}

Any MCP-compatible client

The server speaks standard MCP over streamable HTTP. Point any client at:

• URL: http://your-server:39099/mcp
• Auth header: Authorization: Bearer <YOUR_MCP_API_KEY>
• Transport: Streamable HTTP (POST)
• Protocol version: 2025-03-26

Standalone CLI Client

A built-in interactive client is included for testing or scripting.

Quick install

curl -fsSL https://raw.githubusercontent.com/DaccordProject/accordserver-mcp/main/install.sh | bash

Install & run (manual)

npm install
npm run build
npm start

Environment variables

Example session

$ export ACCORD_MCP_API_KEY="your-key"
$ npm start

Connecting to http://localhost:39099/mcp...
Connected. Type 'help' for commands.

accord> info
accord> spaces
accord> channels abc123
accord> messages def456 10
accord> send def456 Hello from the CLI!
accord> exit

CLI commands

Available Tools

Read Operations

Write Operations

Moderation

Protocol Details

• Transport: Streamable HTTP (POST)
• Endpoint: POST /mcp
• Auth: Authorization: Bearer <MCP_API_KEY>
• Protocol version: 2025-03-26
• Format: JSON-RPC 2.0

Security Notes

• The MCP API key grants full administrative access to the server (read all messages, send as system, kick/ban users)
• Treat it like a root credential -- do not expose it in client-side code or logs
• The endpoint is disabled entirely unless MCP_API_KEY is set on the server
• Key comparison uses constant-time equality to prevent timing attacks
• Messages sent via MCP are attributed to author "mcp" for auditability