Connects AI agents to Accord chat server instances via the Model Context Protocol
Accord MCP
MCP (Model Context Protocol) clients for the Accord ecosystem. This package provides two distinct MCP clients:
| Client | Connects to | Auth | Scope | Use case |
|---|---|---|---|---|
Server MCP (accord-mcp) |
accordserver (port 39099) | Server-wide MCP_API_KEY |
Full admin | Server automation, bots, data seeding |
Client MCP (daccord-mcp) |
daccord desktop app (port 39101) | Per-account bearer token | User's permissions + UI control | Personal AI assistant, UI auditing, testing |
Prerequisites
Server MCP
- An Accord server running with
MCP_API_KEYset - The server's base URL (e.g.
http://localhost:39099)
Client MCP
- The daccord desktop app running with Developer Mode enabled
- MCP Server toggled on in App Settings > Developer
- The bearer token from the Developer settings page
Agent Setup
Server MCP (accordserver)
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"
}
}
}
}
Client MCP (daccord desktop app)
The daccord desktop app exposes a local MCP server on port 39101 when Developer Mode is enabled. This provides user-scoped access plus UI control, navigation, and screenshot capabilities.
Claude Code
{
"mcpServers": {
"daccord": {
"type": "streamable-http",
"url": "http://localhost:39101/mcp",
"headers": {
"Authorization": "Bearer YOUR_DACCORD_MCP_TOKEN"
}
}
}
}
Or add it interactively:
claude mcp add daccord --transport http http://localhost:39101/mcp \
-H "Authorization: Bearer YOUR_DACCORD_MCP_TOKEN"
Using Both Together
An AI agent can use both MCP servers simultaneously -- server MCP for admin tasks and data seeding, client MCP for navigating the UI and visually verifying results:
{
"mcpServers": {
"accord": {
"type": "streamable-http",
"url": "http://localhost:39099/mcp",
"headers": {
"Authorization": "Bearer YOUR_MCP_API_KEY"
}
},
"daccord": {
"type": "streamable-http",
"url": "http://localhost:39101/mcp",
"headers": {
"Authorization": "Bearer YOUR_DACCORD_MCP_TOKEN"
}
}
}
}
Any MCP-compatible client
Both endpoints speak standard MCP over streamable HTTP:
- Server:
http://your-server:39099/mcp+Authorization: Bearer <MCP_API_KEY> - Client:
http://localhost:39101/mcp+Authorization: Bearer <DACCORD_TOKEN> - Transport: Streamable HTTP (POST)
- Protocol version:
2025-03-26
Standalone CLI Clients
Server CLI (`accord-mcp`)
Interactive client for the accordserver MCP endpoint.
npm install && npm run build
export ACCORD_MCP_API_KEY="your-key"
npm start
| Variable | Description | Default |
|---|---|---|
ACCORD_MCP_URL |
Server MCP endpoint URL | http://localhost:39099/mcp |
ACCORD_MCP_API_KEY |
Server MCP API key (required) | -- |
Client CLI (`daccord-mcp`)
Interactive client for the daccord desktop app's local MCP server.
npm install && npm run build
export DACCORD_MCP_TOKEN="your-token"
npm run start:client
| Variable | Description | Default |
|---|---|---|
DACCORD_MCP_URL |
Client MCP endpoint URL | http://localhost:39101/mcp |
DACCORD_MCP_TOKEN |
Client MCP bearer token (required) | -- |
Copy the token from daccord's App Settings > Developer > MCP Server section.
Environment Variables
ACCORD_MCP_API_KEYrequiredServer MCP API key for authenticationACCORD_MCP_URLServer MCP endpoint URLDACCORD_MCP_TOKENrequiredClient MCP bearer token for daccord desktop appDACCORD_MCP_URLClient MCP endpoint URLConfiguration
{"mcpServers": {"accord": {"type": "streamable-http", "url": "http://localhost:39099/mcp", "headers": {"Authorization": "Bearer YOUR_MCP_API_KEY"}}}}