Article

Unthread Admin MCP

5 min read

Last updated 4 hours ago

Unthread supports the Model Context Protocol (MCP), allowing you to connect your AI assistant to your Unthread workspace.

As of 4/16/26 Unthread is an official Anthropic Partner available in Tools and Plugins under the Model Context Protocol section:

Current capabilities and limitations

What data is available (read): The MCP currently supports reading:

Conversations
Users
Analytics
Knowledge base (read-only endpoints)
Custom fields / ticket types
Surveys
- There are five read-only MCP endpointTool wrappers for survey analytics: list_surveys, get_survey_analytics, list_survey_responses, get_outbound_survey, and list_outbound_survey_responses, including Zod list/field allowlists and request-building that separates path params, optional query filters, and bodies.
  Use get_survey_analytics date-range validation (requires startDate and endDate together) for date filtering.
External Tasks
- Add external_task_projects plus materialized project_id / project_lookup_key arrays, trigger/view updates, and GIN indexes for provider/project filtering.
- Add externalTaskProjectId analytics grouping/filtering with project-name lookup and per-conversation/project deduping.
- Add opportunistic project lookup upserts on external task writes plus a dry-run-default backfill script. Backfill entry point: node scripts/backfill-external-task-projects.js --tenant-id <tenant> --dry-run, then rerun with --run when ready.

What data is available (write): The MCP currently supports writing:

update_conversation tool available in MCP
create_conversation_comment tool available in MCP (supports Slack block format)
create_approval_request tool available in MCP

Setup Instructions

Claude.ai (Web)

Go to claude.ai and sign in
Navigate to Settings → Connectors → Add custom connector
Enter a name (e.g., “Unthread”) and the server URL:
```
https://app.unthread.io/api/mcp
```

Click Add and follow the authorization prompt
Sign in with your Unthread account when prompted
Authorize the connection to grant Claude access to your workspace

You’ll be asked to authorize access to your Unthread workspace. This uses secure OAuth authentication - your password is never shared with Claude.

Claude Code (CLI)

Open your Claude Code configuration file at ~/.claude.json
Add Unthread to the mcpServers section:

{
  "mcpServers": {
    "unthread": {
      "url": "https://app.unthread.io/api/mcp"
    }
  }
}

Restart Claude Code
When you first use an Unthread tool, you’ll be prompted to authenticate via your browser

Cursor

Option A: Cursor Deeplink

Just click this button!

Option B: OAuth (browser sign-in)

Open Cursor Settings → MCP → Add new global MCP server
This opens your ~/.cursor/mcp.json file. Add Unthread to the mcpServers section:

{
  "mcpServers": {
    "Unthread": {
      "url": "https://app.unthread.io/api/mcp"
    }
  }
}

Save the file and restart Cursor. The Unthread MCP should now show up in your Cursor Settings.
When you first use an Unthread tool, you’ll be prompted to authenticate via your browser

Option C: Hosted MCP (service account API key)

If you want to connect to Unthread’s hosted MCP using a service-account token, configure Cursor to use the Unthread API endpoint and attach the token as an HTTP header.

Open ~/.cursor/mcp.json
Add an entry like this:

{
  "mcpServers": {
    "unthread": {
      "url": "https://api.unthread.io/api/mcp",
      "headers": {
        "X-Api-Key": "MYKEY"
      }
    }
  }
}

Example Prompts

Try asking your AI assistant:

Monthly support analytics dashboard (prompt template)

“List my open conversations”
“Show me conversations from the last week”
“What’s our ticket volume trend this month?”
“Find the conversation about the billing issue”

Copy/paste and replace the bracketed values:

Show me a support dashboard for [month] using the Unthread MCP for project [project name or ID]. Include: total tickets, resolved count and resolution rate, open/in-progress breakdown, critical ticket count, mean and median response time, P95 response time, mean and median resolution time, weekly volume and resolved trend charts, response time trend by week, agent workload by tickets resolved, average resolution time per agent, priority breakdown (critical/high/medium/low), and channel mix (Slack/email/portal). Pull all data from the analytics API and highlight any key insights like workload concentration, mean vs. median gaps, or outlier agents.

Troubleshooting

”Authorization failed” error

Make sure you’re signed in to Unthread with the correct account. The OAuth flow should open a browser window - if it doesn’t, check if pop-ups are blocked.

Security

OAuth 2.0: We use industry-standard OAuth 2.0 with PKCE for secure authentication
No password sharing: Your Unthread credentials are never shared with AI assistants
Scoped access: The AI assistant can only access data you have permission to view
Revocable: You can disconnect the integration at any time from your Unthread settings

For more details on our security practices, visitunthread.io/security.

Sentiment Scores

Unthread MCP