MCP Server Overview

Connect Claude, Cursor, ChatGPT, and other MCP clients to your Coherence workspace.

Coherence ships an official Model Context Protocol server: @coherenceos/mcp-server. It lets MCP-compatible clients — Claude Desktop, Cursor, Cline, Windsurf, VS Code, ChatGPT — read from your workspace and ask its AI agent (Nash) to take action.

Source: github.com/getcoherence/mcp-server · MCP Registry: io.getcoherence/mcp

What you can do

Talk to your agent. The headline tool, chat_with_agent, sends a natural-language request to Nash and returns its reply. Nash has its full internal toolset — sending email, drafting outreach, creating reminders, updating records, posting to social, creating landing pages — all governed by your workspace's approval rules. From Claude Desktop:

"Ask my Coherence agent to draft a follow-up email to the leads I created this week."

"Have Nash check what's on my calendar today and remind me about the most important meeting an hour before."

Read data directly. For raw lookups where you don't want a full agent round-trip, the server exposes fast-path tools: list_modules, list_records, get_record, create_record, update_record, delete_record, plus the outreach CRUD tools. These hit api.getcoherence.io/v1/* directly and return in under a second.

The full tool list

ToolWhat it does
chat_with_agentSend a message to a Coherence agent; agent runs its multi-step tool loop and returns its reply
list_modulesList CRM modules in the workspace
list_module_fieldsList fields defined on a module
list_recordsList records in a module with search + pagination
get_recordGet a single record by ID
create_recordCreate a new record
update_recordUpdate a record's fields
delete_recordSoft-delete a record
list_outreach_itemsList blog articles, LinkedIn posts, emails
get_outreach_itemGet a single outreach item (with MDX content)
create_outreach_itemDraft a new outreach item
update_outreach_bodyUpdate the body of an outreach item
update_outreach_itemUpdate outreach metadata (title, status)

For anything not in this list — sending email, creating reminders, posting to social, creating landing pages, managing approvals — the right move is chat_with_agent. The agent has those tools and will use the right one.

Security & permissions

Authentication is via an API key (sk_live_…) you create in Settings → API Keys in your workspace. Keys inherit the creating user's permissions and can be optionally scoped:

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

Approval gates (sendEmail, postToSocial, createLandingPage, etc.) are enforced inside the Coherence platform regardless of which scopes a key holds. An MCP user cannot bypass approval flows that exist for human users.

Read more in the Authentication docs →

What's next