CraftCX MCP server

The CraftCX MCP server connects compatible AI assistants and coding agents to your CraftCX data through the Model Context Protocol. Connect it to search conversations, findings, customer signals, and support performance from your AI client. CraftCX uses OAuth, limits each connection to one organization, and allows read-only access.

Connect a client

Add the CraftCX remote MCP server to your AI client:

https://mcp.craftcx.com/mcp

Run your client’s MCP authentication command and sign in to CraftCX.

Your client can use CraftCX tools after you approve access to an organization.

Endpoint

Transport	URL
Streamable HTTP	`https://mcp.craftcx.com/mcp`

Read the protected resource metadata at:

https://mcp.craftcx.com/.well-known/oauth-protected-resource/mcp

Authentication

CraftCX MCP uses OAuth. When you connect a client, it opens a browser flow so you can sign in to CraftCX and approve access for an organization. You do not create an API token for MCP. Authorization uses your CraftCX account and the scopes you approve during consent.

Permissions

CraftCX grants access through these scopes:

Scope	What it unlocks
`conversations:read`	Support conversations, messages, scores, and topics
`findings:read`	QA findings and operational incidents
`signals:read`	Customer signals and signal groups
`supportPerformance:read`	Aggregate AXIS scores, resolution outcomes, and trends

Tools only appear when the session includes the matching scope. The MCP server is currently read-only.

Available tools

Tool	Description	Example use
`whoami`	Return the authenticated user, organization, and approved scopes	Confirm which organization and scopes the session can use
`list-signals`	List recent customer signals	See what surfaced most recently
`search-signals`	Search persistent customer signals by text, type, and date	Find refund or shipping signals in a date range
`get-signal-group`	Retrieve a signal group with trends and representative evidence	Inspect a recurring customer issue
`search-signal-groups`	Search signal groups by text and type, or list recent groups	Find groups related to a product area
`search-conversations`	Search conversations by text, date, AXIS score, topic, and resolution status	Find low-scoring refund conversations
`get-conversation`	Retrieve a full conversation with messages, evaluations, scores, topics, findings, and signals	Dig into one conversation with evidence
`analyze-support-performance`	Analyze aggregate AXIS scores, resolution outcomes, and trends	Summarize quality over the last 30 days
`search-findings`	Search QA findings and incidents by text, priority, source, or status	List open high-priority findings
`get-finding`	Retrieve a finding or incident with evidence and related conversations	Review one finding end to end
`analyze-findings`	Summarize emerging and unresolved findings and incidents	Ask what needs attention this week

Learn more about the product concepts these tools return:

Configure a client

Most agents are smart enough for you to simply ask them;

Add the CraftCX MCP server. Use the remote URL https://mcp.craftcx.com/mcp.

Cursor

Open Cursor Settings → MCP → Add new global MCP server
Paste:

{
  "mcpServers": {
    "craftcx": {
      "url": "https://mcp.craftcx.com/mcp"
    }
  }
}

Save and restart Cursor if needed. Complete the OAuth flow the first time you use a CraftCX tool.

To share the config with your team, add the same block to .cursor/mcp.json in the project root.

Claude Code

claude mcp add --transport http craftcx https://mcp.craftcx.com/mcp

Then run /mcp in Claude Code and complete the OAuth flow.

Codex

Add the server with the CLI:

codex mcp add craftcx --url=https://mcp.craftcx.com/mcp

Or add the server to your ~/.codex/config.toml file:

[mcp_servers.craftcx]
url = "https://mcp.craftcx.com/mcp"

Then authenticate:

codex mcp login craftcx

Complete the OAuth flow when prompted.

OpenCode

CraftCX publishes an OpenCode remote config:

https://craftcx.com/.well-known/opencode

That endpoint advertises the CraftCX MCP server. OpenCode loads it when you authenticate against a provider that supports well-known remote config. You can also add the server by hand in opencode.json or opencode.jsonc:

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "craftcx": {
      "type": "remote",
      "url": "https://mcp.craftcx.com/mcp",
      "oauth": {}
    }
  }
}

Then authenticate:

opencode mcp auth craftcx

Complete the OAuth flow when prompted. See the OpenCode MCP docs for more options.

VS Code (GitHub Copilot)

Create .vscode/mcp.json in your workspace:

{
  "servers": {
    "craftcx": {
      "type": "http",
      "url": "https://mcp.craftcx.com/mcp"
    }
  }
}

Open the Command Palette, run MCP: List Servers, start the CraftCX server, and complete OAuth when prompted.

Claude Desktop

Open Settings → Connectors
Add a connector with URL https://mcp.craftcx.com/mcp
Complete the OAuth flow

Other clients

If your tool supports remote MCP over Streamable HTTP, use this URL:

https://mcp.craftcx.com/mcp

If the client only supports local stdio servers, bridge with mcp-remote:

{
  "mcpServers": {
    "craftcx": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://mcp.craftcx.com/mcp"]
    }
  }
}

Example prompts

After you connect a client, try these prompts:

“What are the open high-priority findings in CraftCX?”
“Search CraftCX for conversations about refunds with low AXIS scores this month.”
“Summarize support performance for the last 30 days.”
“Show recent customer signal groups related to shipping delays.”
“Open the latest refund conversation and explain its findings and signals.”

Troubleshooting

Complete the OAuth consent flow and select the correct organization.
If tools are missing, confirm the session approved the matching *:read scopes.
Disconnect and reconnect in your client’s MCP settings if authentication fails.
Confirm you can sign in to app.craftcx.com with access to that organization.

Get Started

Features

Support Observability

Integrations

AI

AI Agents

CraftCX MCP server

Connect a client

Endpoint

Authentication

Permissions

Available tools

Configure a client

Cursor

Claude Code

Codex

OpenCode

VS Code (GitHub Copilot)

Claude Desktop

Other clients

Example prompts

Troubleshooting

​Connect a client

​Endpoint

​Authentication

​Permissions

​Available tools

​Configure a client

​Cursor

​Claude Code

​Codex

​OpenCode

​VS Code (GitHub Copilot)

​Claude Desktop

​Other clients

​Example prompts

​Troubleshooting

Connect a client

Endpoint

Authentication

Permissions

Available tools

Configure a client

Cursor

Claude Code

Codex

OpenCode

VS Code (GitHub Copilot)

Claude Desktop

Other clients

Example prompts

Troubleshooting