SuzyQ MCP Server
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@SuzyQ MCP Server Ask SuzyQ how to create a new mission"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
SuzyQ MCP Server
An MCP (Model Context Protocol) server to interact with the SuzyQ chatbot directly from Cursor IDE.
What is this?
This server allows you to use SuzyQ (your research co-pilot) directly from Cursor using the MCP protocol. You can ask questions about surveys, missions, actions, data analysis, and more — without leaving your IDE.
Related MCP server: Cursor DB MCP Server
Features
Chat with SuzyQ: Send messages and receive responses from the chatbot
Conversation History: Maintains context across your conversations
Multiple Conversations: Support for multiple active conversations
Installation
1. Install dependencies
cd mcp-server-suzyq
npm installOr use the installation script:
./install.sh2. Configure in Cursor
Edit your Cursor MCP configuration file (Settings > MCP Servers) or directly edit the configuration file at:
macOS: ~/.cursor/mcp.json
Linux: ~/.config/cursor/mcp.json
Add the following configuration:
{
"mcpServers": {
"suzyq": {
"command": "node",
"args": ["/path/to/mcp-server-suzyq/index.js"]
}
}
}Important! Replace /path/to/ with the actual absolute path to the project.
3. Restart Cursor
Close and reopen Cursor to load the new MCP server.
Usage
Once configured, you can use the following tools in your conversations with Claude in Cursor:
ask_suzyq
Send a message to SuzyQ and receive a response.
Example usage in Cursor:
"Ask SuzyQ how to create a new mission"
"Ask SuzyQ about data cleaning best practices"Parameters:
message(required): The message to send to SuzyQconversation_id(optional): Conversation ID to continue a previous conversation
new_suzyq_conversation
Start a new conversation with SuzyQ.
Example:
"Start a new conversation with SuzyQ"get_suzyq_conversation_history
Get the conversation history for a specific conversation.
Parameters:
conversation_id(required): The conversation ID to retrieve history for
Example Prompts
Here are some examples of how you can interact with SuzyQ from Cursor:
General questions:
"Ask SuzyQ: How do I create a survey with skip logic?"
"Ask SuzyQ about quota management best practices"
Continue conversations:
"Continue conversation conv_123456 asking about data cleaning"
Code analysis:
"Ask SuzyQ how we can improve the quotas component"
Architecture
The MCP server acts as a bridge between Cursor and the Chatbase API:
Cursor <-> MCP Server <-> Chatbase API <-> SuzyQChatbot ID:
TujsCRqvQAdt7loeL2b9NAPI Endpoint:
https://www.chatbase.co/api/chat/[chatbotId]
Troubleshooting
Server doesn't appear in Cursor
Verify the path in the configuration is absolute and correct
Check that Node.js is installed (
node --version)Make sure dependencies are installed (
npm install)Completely restart Cursor
Error sending messages
Check your internet connection
Verify the chatbot ID is correct
Check the server logs in the Cursor console
How to view logs?
MCP server logs appear in Cursor's debug output. To view them:
Open the command palette (Cmd/Ctrl + Shift + P)
Search for "Developer: Toggle Developer Tools"
Go to the "Console" tab
Development
To modify the server:
Edit
index.jsRestart Cursor to load the changes
Notes
Conversations are stored in memory and will be lost when the server restarts
The server uses the public Chatbase API, no special authentication required
User-specific context (user_id, brand_id, etc.) is not included in this basic version
Roadmap
Persist conversations to disk
Support for user context (user_id, brand_id)
Integration with Azure Functions context hash
Support for streaming responses
License
MIT
Available Tools
3 toolsask_suzyqB
Send a message to SuzyQ chatbot and get a response. SuzyQ is your research co-pilot that can help you with questions about surveys, missions, actions, data analysis, and more within the Suzy platform.
Inputs: message (required), conversation_id.
get_suzyq_conversation_historyB
Get the conversation history for a specific conversation with SuzyQ.
Inputs: conversation_id (required).
new_suzyq_conversationA
Start a new conversation with SuzyQ. This will clear the current conversation history and start fresh.
Inputs: no named parameters.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 3 tools
Each tool serves a distinct, non-overlapping function: sending a message, starting a fresh conversation, and retrieving history. There is no ambiguity about which tool to invoke for a given action.
All tool names follow a clear verb_suzyq_noun snake_case pattern: ask_suzyq, new_suzyq_conversation, get_suzyq_conversation_history. Naming is predictable and easy to learn.
Three tools is an appropriate, minimal set for the server's stated purpose of interacting with a SuzyQ chatbot session. Each tool is meaningful and there is no bloat or obviously missing core function.
The core lifecycle of a chatbot session is covered: start, ask, and retrieve history. Minor gaps like explicitly deleting a conversation or listing past conversations exist, but they are not essential to the primary workflow.
Related MCP Connectors
Persistent memory for Claude Code and Cursor. Stop re-explaining your project every session.
Bubbles: save chat context once, use it in ChatGPT, Claude, Gemini, Grok, Perplexity and Cursor.
Ask your own documents and get answers that cite the source passage. Workspace knowledge bases over MCP for Cursor, Claude and any MCP client.
Search and reason over your Obsidian-style Markdown vault, right from ChatGPT.
Related MCP Servers
- FlicenseNot gradedqualityDmaintenanceImplements a RAG workflow that integrates with any custom knowledge base and can be triggered directly from the Cursor IDE.-
- AlicenseNot gradedqualityDmaintenanceEnables querying, searching, and analyzing Cursor IDE conversation history from SQLite workspaceStorage databases. Supports exporting chat data in multiple formats and provides workspace utilities for managing conversation data across projects.MIT
- FlicenseNot gradedqualityDmaintenanceEnables multi-agent research with web search and analysis, accessible via VS Code Copilot tools.-
- FlicenseNot gradedqualityDmaintenanceEnables querying Cisco CX Assistant (production and stage) directly from Cursor using natural language, with browser-based authentication via Google Chrome.-