@coherenceos/mcp-server

@coherenceos/mcp-server

MCP (Model Context Protocol) server that exposes Coherence platform APIs as tools for Claude, Cursor, Cline, and other MCP-compatible clients.

Quickstart

1. Create an API key

In Coherence, go to Settings → API Keys → Create new key. Copy the sk_live_… value — it's only shown once.

2. Add to your MCP client

Claude Desktop (~/Library/Application Support/Claude/claude_desktop_config.json on macOS, %APPDATA%\Claude\claude_desktop_config.json on Windows):

{
  "mcpServers": {
    "coherence": {
      "command": "npx",
      "args": ["-y", "@coherenceos/mcp-server"],
      "env": {
        "COHERENCE_API_URL": "https://api.getcoherence.io/v1",
        "COHERENCE_API_TOKEN": "sk_live_..."
      }
    }
  }
}

Cursor / Cline / Continue / Windsurf: same JSON, dropped into each tool's MCP settings file.

Local development — point at your gateway:

"env": {
  "COHERENCE_API_URL": "http://localhost:4000",
  "COHERENCE_API_TOKEN": "sk_live_..."
}

Available Tools

Tool	Description
list_modules	List all CRM modules in the workspace
list_module_fields	List fields defined on a module
list_records	List records with search/pagination
get_record	Get a single record by ID
create_record	Create a new record
update_record	Update a record's fields
delete_record	Soft-delete a record
list_collab_docs	List Collab documents
create_collab_doc	Create a new document
get_collab_doc	Get document metadata
get_collab_doc_text	Get document plain-text content
list_agents	List AI agents
create_agent_task	Assign a task to an agent
list_agent_tasks	List agent tasks (filterable by status)
add_comment	Add a comment to a record
workspace_overview	Get workspace summary stats

Environment Variables

Variable	Required	Default	Description
COHERENCE_API_TOKEN	Yes	—	API key (sk_live_…) from your Coherence workspace
COHERENCE_API_URL	No	https://api.getcoherence.io/v1	API base URL

Hosted MCP (no install)

Prefer a hosted endpoint? Use Coherence's Streamable HTTP MCP server directly:

https://mcp.getcoherence.io

Authenticate with the same sk_live_… API key. Supported in Claude.ai connectors, ChatGPT, and any MCP client that speaks HTTP/SSE.

Scopes

When you create an API key, you choose which scopes it can use:

• records:read, records:write
• collab:read, collab:write
• agents:read, agents:write
• workspace:read

A key with no scopes selected has full access for the creating user's roles.

Local development (no published build)

"command": "npx",
"args": ["tsx", "packages/mcp-server/src/index.ts"]