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 URL