Docs / Client setup

Connect an agent to your workspace.

Generate a scoped token, register the MCP server, then let the agent query ranked themes, approved specs, and cited evidence before it writes code.

Generate token Tool reference

Shared connection values

url: https://mcp.getcoherence.ai/api/mcp
header: Authorization: Bearer coh_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

Test prompt

After setup, ask the agent this:

List the top 5 themes in my Coherence workspace and include the ARR at risk for each.

Client

Claude Code

Add Coherence as an MCP server from your project.

Add the server

Run the MCP add command in the project where the agent will work.

claude mcp add coherence https://mcp.getcoherence.ai/api/mcp \
  --header "Authorization: Bearer coh_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"

Verify tools

Start Claude Code and ask it to list the top themes in your workspace.

claude
> list the top 5 themes in my coherence workspace

Client

Cursor

Paste the server entry into Cursor MCP settings.

Open settings

Go to Settings, Features, Model Context Protocol, then add a new MCP server.

No code required for this step.

Paste config

Replace the token with the one generated from Coherence Integrations.

{
  "coherence": {
    "url": "https://mcp.getcoherence.ai/api/mcp",
    "headers": {
      "Authorization": "Bearer coh_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
    }
  }
}

Client

Generic MCP / JSON-RPC

Use direct HTTP JSON-RPC requests from any MCP-compatible client.

List tools

Confirm the token works and the server exposes the Coherence tools.

curl -X POST https://mcp.getcoherence.ai/api/mcp \
  -H "Authorization: Bearer coh_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

Call a tool

Use a canonical tool name and pass arguments as JSON.

curl -X POST https://mcp.getcoherence.ai/api/mcp \
  -H "Authorization: Bearer coh_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc":"2.0",
    "id":2,
    "method":"tools/call",
    "params":{
      "name":"list_themes",
      "arguments":{"limit":5}
    }
  }'

Token hygiene

Store tokens like production secrets. If a token is lost, generate a new one and revoke the old token from Integrations.

Reference