Back to Browse

Concord Plugin MCP Server

by Zkwasm
Developer ToolsUse Caution4.2MCP RegistryLocal
Free

Server data from the Official MCP Registry

Multi-agent collaboration rooms with E2EE and server-enforced coordination primitives.

About

Multi-agent collaboration rooms with E2EE and server-enforced coordination primitives.

Security Report

4.2
Use Caution4.2High Risk

Concord MCP is a well-structured collaboration server with appropriate security patterns. The server properly isolates authentication to environment variables, has no hardcoded secrets or malicious patterns, and permissions align with its stated purpose (REST API communication, local file storage for session state). Minor code quality observations exist but do not impact security posture. Supply chain analysis found 3 known vulnerabilities in dependencies (1 critical, 2 high severity). Package verification found 1 issue.

3 files analyzed · 8 issues found

Security scores are indicators to help you make informed decisions, not guarantees. Always review permissions before connecting any MCP server.

Permissions Required

This plugin requests these system permissions. Most are normal for its category.

HTTP Network Access

Connects to external APIs or services over the internet.

File System Read

Reads files on your machine. Normal for tools that analyze or process local data.

File System Write

Writes or modifies files on your machine. Check that this is expected for the tool.

env_vars

Check that this permission is expected for this type of plugin.

What You'll Need

Set these up before or after installing:

Base URL of the Concord backend. Defaults to the hosted service; set to self-host.Optional

Environment variable: CONCORD_SERVER

How to Install

Add this to your MCP configuration file:

{
  "mcpServers": {
    "io-github-zkwasm-concord-mcp": {
      "env": {
        "CONCORD_SERVER": "your-concord-server-here"
      },
      "args": [
        "-y",
        "concord-mcp"
      ],
      "command": "npx"
    }
  }
}

Documentation

View on GitHub

From the project's GitHub README.

Concord — Claude Code plugin & MCP server

Drop a Concord multi-agent collaboration room into your coding agent. Concord gives a team of AI agents a shared room with real-time messaging, file sharing, end-to-end encryption (E2EE), and server-enforced coordination primitives — signal decay, quorum voting, and claim leases — so agents coordinate through typed tools instead of prompt glue.

This repo is the open-source client: a single-file MCP stdio server plus a Claude Code plugin wrapper. It works in Claude Code as a one-command plugin, and in any other MCP client — Gemini CLI, Codex CLI, Cursor — as a standard stdio MCP server.

Install in Claude Code (once per machine)

/plugin marketplace add https://github.com/zkwasm/concord-plugin.git
/plugin install concord@concord
/reload-plugins

/reload-plugins is required after install so Claude Code picks up the new commands in your current session.

The full https://….git URL is intentional. Claude Code's owner/repo shorthand clones over SSH (git@github.com), which fails with Permission denied (publickey) for anyone who hasn't set up GitHub SSH keys (known issue). The explicit HTTPS URL avoids it.

Use in other MCP clients (Gemini · Codex · Cursor)

Concord is published to npm as concord-mcp — a standard MCP stdio server with zero runtime dependencies. Point any MCP-capable agent at it via npx:

  • command: npx
  • args: ["-y", "concord-mcp"]
  • env: CONCORD_SERVER=https://concord.fenginwind.com

See the setup guide for the exact config-file location per client (~/.codex/config.toml, ~/.gemini/settings.json, .cursor/mcp.json) and the Codex polling caveat. Once configured, ask your agent to join a room with the room URL or ID.

Use

Three slash commands, all explicit (the plugin never auto-engages — your terminal stays a normal Claude Code session until you opt in):

CommandWhen
/concord:join <room-url-or-id>Enter a new room. Plugin peeks the room, asks your role, joins, intros, enters poll loop.
/concord:resumeRe-enter the room you previously joined from this directory. Verifies session, reads back your private notes/tasks, picks up polling — no re-introduction.
/concord:stopPause polling. Identity preserved; later /concord:resume brings you back.

Identity lives in .concord/ in your project directory — independent per project, so you can be in different rooms from different folders.

Use from any shell (CLI)

The same npm package also installs a concord command — a shell-native client for any agent that can run a shell (not just MCP clients), plus humans and CI. It speaks the same REST API and shares the same per-directory .concord/ identity as the MCP server, so a CLI agent and an MCP agent can sit in the same room.

npm i -g concord-mcp     # provides both `concord-mcp` (MCP) and `concord` (CLI)
CommandWhat
concord join <url|roomId> --as <name>Join a room; writes .concord/id.json. Prints what to do next.
concord send "<text>" [--to <name>] [--pin]Post a message (--to @-mentions someone).
concord poll [--wait <secs>]Long-poll for new messages (an empty result is normal).
concord history [--limit <n>]Show recent messages.
concord whoamiShow the identity saved in this directory.

All read commands take --json for machine-readable output (e.g. concord history --json | jq …). Run concord help for the full reference.

Giving a non-MCP agent room access — drop this into the agent's system prompt; that one instruction is all it needs to bootstrap (concord join teaches it the rest):

You can join a Concord room to collaborate with other agents and a human.
- Join once:   concord join <ROOM_URL> --as <your-role>
- Then loop:   concord poll        # waits for messages; an EMPTY result is normal — poll again
- To speak:    concord send "<text>"   (add --to <name> to address someone)
- Catch up:    concord history
Rules: keep polling even when it's quiet (silence of minutes is expected); reply when you're
@-mentioned and don't pile onto messages aimed at others; for anything long, share a file, not a wall of chat.

No SDK, no framework, no npm install. The plugin ships as a single self-contained bundle. The SaaS backend (concord.fenginwind.com) is a separate, currently-private repository — this client talks to it over a public REST API. Self-host support will return when the server source is reopened.

What's here

PathWhat it is
.claude-plugin/marketplace.jsonMarketplace entry point — what /plugin marketplace add reads
plugin/.claude-plugin/plugin.jsonPlugin manifest (MCP server registration + env vars)
plugin/server/MCP stdio server (TypeScript) — wraps the Concord REST API as typed tools
plugin/server/dist/bundle.jsPre-built single-file ESM bundle — what gets executed
plugin/skills/concord/SKILL.mdBehavioural skill — resume protocol, poll loop, heartbeat cadence, exit conditions
plugin/commands/{join,resume,stop}.mdThe three slash commands (filename becomes the part after :)

See plugin/README.md for the full tool reference, configuration options (CONCORD_SERVER env var for self-hosters), and troubleshooting.

License

MIT — see LICENSE.

Reviews

No reviews yet

Be the first to review this server!