Magic Insights

What Magic Insights MCP server does

The Magic Insights MCP server exposes read-only access to a Magic Insights workspace through MCP. It lets an agent inspect the workspace at a high level, browse studies, examine generated analysis, and retrieve the underlying customer feedback used by that analysis.

Workspace-level tools report the plan, study count, connected platforms, tags, feedback total, date range, and overall sentiment. Study tools provide descriptions, date ranges, summaries, generated reports, top themes, topic groupings, and AI-synthesized suggestions. Suggestions include a problem, proposed solution, and priority, while a separate tool returns the feedback behind a suggestion.

The server also supports direct feedback research. Agents can search by keyword, sentiment, platform, tag, or date range; retrieve an individual item with its content, translation, AI summary, and source metadata; and review aggregate statistics or time-based trends. Tags and source platforms can be listed with their associated counts.

How it works

The Magic Insights MCP server is hosted remotely at https://app.magicinsights.ai/api/mcp. It uses Streamable HTTP rather than a local process, so an MCP client sends requests to the endpoint over the network. Authentication uses an API key created for a Magic Insights workspace and supplied in the Authorization: Bearer <key> header.

All tools are scoped to the workspace associated with that key, and all exposed operations are read-only. Trend results can be grouped by week or month. Theme feedback is returned with the most relevant items first, while study and suggestion tools connect higher-level analysis with representative or source feedback.

Setup and configuration

Create an API key in the Magic Insights application under Settings → API keys. Configure the client with the server URL and add the key as an authorization header. No package installation or local server process is required.

For Claude Code, add the remote server with its HTTP transport and authorization header. Cursor uses an mcpServers entry in either the user-level ~/.cursor/mcp.json file or a project-level .cursor/mcp.json file. Claude Desktop and Windsurf use the same general MCP server configuration pattern, although the location and exact setup flow depend on the client. The Claude API MCP connector accepts the endpoint with an authorization token.

Tools and capabilities

The Magic Insights MCP server provides these operations:

• Inspect workspace metadata, connected platforms, tags, feedback totals, and overall sentiment.
• List studies and retrieve a study's report, summary, themes, and examples.
• List topics and the themes grouped within each topic.
• Retrieve feedback associated with a theme or suggestion.
• Search feedback using text and structured filters.
• Read full feedback records, including translations, summaries, and source details.
• Calculate sentiment and volume statistics, including weekly or monthly trends.
• List custom tags and source platforms with item counts.

Limitations and notes

The server does not write to the workspace: its tools only read existing data. Access is limited to the workspace that owns the API key. The application source is closed, while this repository contains the public server metadata and connection documentation.

The available data depends on what is present in the connected Magic Insights workspace. The server provides access to studies, feedback, and analysis already represented there; it does not document tools for creating studies, editing feedback, or changing tags. A valid workspace API key is required for requests.