streamable-httpupdated 2mo ago
Connect any MCP client to your Magic Insights workspace and chat with your customer-feedback studies — list studies, search and filter feedback, and read AI-generated themes, topics, suggestions, tags, and sentiment trends.
What can you do with Magic Insights?
Magic Insights MCP server
Connect any MCP client to your Magic Insights workspace and chat with your customer-feedback studies — list studies, search and filter feedback, and read AI-generated themes, topics, suggestions, tags, and sentiment trends.
This is a remote, hosted MCP server. There's nothing to install — point your client at the URL below and authenticate with a workspace API key.
- Server URL:
https://app.magicinsights.ai/api/mcp - Transport: Streamable HTTP
- Auth: API key (bearer token)
- Official MCP registry:
ai.magicinsights/insights
Get an API key
Create one in the app at Settings → API keys (https://app.magicinsights.ai → your workspace → Settings → API keys), then send it as the Authorization: Bearer <key> header.
Connect
Claude Code
claude mcp add --transport http magic-insights https://app.magicinsights.ai/api/mcp \
--header "Authorization: Bearer YOUR_API_KEY"
Cursor
Add to ~/.cursor/mcp.json (all projects) or .cursor/mcp.json (one project), then enable the server in Cursor settings:
{
"mcpServers": {
"magic-insights": {
"url": "https://app.magicinsights.ai/api/mcp",
"headers": {
"Authorization": "Bearer YOUR_API_KEY"
}
}
}
}
Other clients (Claude Desktop, Windsurf, MCP Inspector, …)
Most clients use the same mcpServers block above — check your client's docs for where its config file lives. The Claude API MCP connector accepts the same URL with an authorization_token.
Tools
All tools are read-only and scoped to the workspace that owns the API key.
| Tool | What it does |
|---|---|
get_workspace |
One-call overview: plan, study count, connected platforms, tags, total feedback, date range, overall sentiment. |
list_studies |
List all studies with description and date range. |
get_study |
A study's summary, generated report, and top themes (with sentiment, ids, and example feedback). |
list_topics |
A study's topics and the themes grouped under each. |
get_theme_feedback |
All feedback under one theme, most relevant first. |
list_suggestions |
A study's AI-synthesized recommended actions (problem, solution, priority). |
get_suggestion_feedback |
The individual feedback behind a single suggestion. |
search_feedback |
Search and filter feedback by keyword, sentiment, platform, tag, or date range. |
get_feedback |
One feedback item in full — content, translation, AI summary, and source metadata. |
get_stats |
Aggregate stats: total count, sentiment breakdown, date range. |
get_trends |
Feedback volume and sentiment over time, bucketed by week or month. |
list_tags |
The workspace's custom tags and how many items carry each. |
list_platforms |
The source platforms feeding the workspace, each with its feedback count. |
About
Magic Insights is an AI-driven customer-feedback analytics platform. Learn more at magicinsights.ai.
The server's metadata is published in the official MCP registry; this repository hosts the public server.json and connection docs. The application source is closed.
Install
Add Magic Insights to your client. Pick the one you use.
claude mcp add --transport http magic-insights https://app.magicinsights.ai/api/mcpcodex mcp add magic-insights --url https://app.magicinsights.ai/api/mcp{
"mcpServers": {
"magic-insights": {
"url": "https://app.magicinsights.ai/api/mcp"
}
}
}Add to `~/.cursor/mcp.json`, or `.cursor/mcp.json` for a single project.
{
"servers": {
"magic-insights": {
"type": "http",
"url": "https://app.magicinsights.ai/api/mcp"
}
}
}Add to `.vscode/mcp.json` in your workspace.
{
"mcpServers": {
"magic-insights": {
"url": "https://app.magicinsights.ai/api/mcp"
}
}
}Add to `claude_desktop_config.json`, then restart Claude Desktop.
{
"mcpServers": {
"magic-insights": {
"serverUrl": "https://app.magicinsights.ai/api/mcp"
}
}
}Add to `~/.codeium/windsurf/mcp_config.json`.
13 tools
Magic Insights exposes 13 tools to a connected agent.
- get_workspace
- One-call overview: plan, study count, connected platforms, tags, total feedback, date range, overall sentiment.
- list_studies
- List all studies with description and date range.
- get_study
- A study's summary, generated report, and top themes (with sentiment, ids, and example feedback).
- list_topics
- A study's topics and the themes grouped under each.
- get_theme_feedback
- All feedback under one theme, most relevant first.
- list_suggestions
- A study's AI-synthesized recommended actions (problem, solution, priority).
- get_suggestion_feedback
- The individual feedback behind a single suggestion.
- search_feedback
- Search and filter feedback by keyword, sentiment, platform, tag, or date range.
- get_feedback
- One feedback item in full — content, translation, AI summary, and source metadata.
- get_stats
- Aggregate stats: total count, sentiment breakdown, date range.
- get_trends
- Feedback volume and sentiment over time, bucketed by week or month.
- list_tags
- The workspace's custom tags and how many items carry each.
- list_platforms
- The source platforms feeding the workspace, each with its feedback count.
Score
64 / 100
Good
- Documentation22/25
- Maintenance16/25
- Trust6/20
- Capability8/15
- Install experience12/15
- Documents what it does and how to connect
- Has a resolvable package or endpoint
- Exposes at least one tool, prompt or resource
- README has substantive content
- Includes a code example
- Documents its configuration
- Mentions credentials or security posture
- Last commit 67 days ago
- Has a release history
- Repository is not archived
- No licence detected
- Namespace verified in the official MCP registry
- Claimed by its owner
- Published under an organisation
- 13 tool(s) documented
- Provides prompt templates
- Provides resources
- 6 documented install method(s)
- Published to a package registry
- Offers a hosted endpoint — no local install
Version history
| Versions | Published |
|---|---|
| 0.1.1Latest | Jun 25, 2026 |
| 0.1.0 | Jun 25, 2026 |