How to Use the Bot9 MCP in Cursor

Q: How do I configure Bot9 in Cursor?

Add the Bot9 MCP server setup to your .cursor/mcp.json file in your project root or your global settings. Once configured, enable Agent mode in your Cursor chat to let the editor invoke the tools.

Q: How do I inspect active Bot9 customer sessions inside Cursor?

Ask the agent to show active threads. It uses listconversations to retrieve the active sessions and can pull individual transcripts using the conversation history tool.

Write code that interacts with your support bots and test conversations inside Cursor.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Bot9 MCP to Cursor

Create your Vinkius account to connect Bot9 to Cursor and route execution through our secure gateway. The platform manages server hosting, runtime updates, and security layers. Configuration requires no manual server provisioning.

GDPR Free for Subscribers

Setup Bot9 with Cursor

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Spin up and test support bots in Cursor Agent Mode

The `create_bot` tool instantiates a new chatbot directly from your editor. When you are writing integration code, your agent calls this tool to spin up test bots so you can write code against live API responses instead of static mock data. The agent then calls `get_bot` to pull the schema and configuration of the newly created bot. This puts real, live JSON responses directly into your active workspace, making it simple to write precise types and handlers.

Manage bot training sources via your MCP Server

The `add_data_source` tool attaches a new URL to your bot's training index. If your codebase contains deployment docs or public guides, your agent reads the file system and pushes those URLs straight to your bot's knowledge base. You can check the training state by letting your agent call `list_data_sources`. It outputs the list of active sources directly into your Cursor chat, ensuring your bot is trained on the correct files before you deploy.

Test bot responses directly inside Cursor

The `send_message` tool sends a test prompt to your chatbot and returns the raw response. This lets you debug your bot's conversational behavior and tone without leaving your code editor or switching to a web dashboard. To debug complex multi-turn chats, the agent uses `get_conversation_history` to pull the transcript of previous turns. You see exactly how the bot processes context, making it easy to tweak your system prompts on the fly.

Setup guide

Set up Bot9 MCP in Cursor

Prerequisites

Cursor installed (macOS, Windows, or Linux)
Active Vinkius subscription with a valid endpoint token

1

Open MCP Settings

Go to Cursor Settings → MCP or open the Command Palette (Cmd+Shift+P / Ctrl+Shift+P) and search for "MCP: Add Server".
2

Add the Bot9 MCP

Cursor will create or open .cursor/mcp.json in your project root. Paste the JSON snippet on the right. Replace [YOUR_TOKEN_HERE] with your endpoint token from cloud.vinkius.com.
3

Enable Agent mode

Open Composer (Cmd+I / Ctrl+I) and switch to Agent mode using the dropdown at the top. MCP tools are only available in Agent mode.
4

Verify the connection

Ask Cursor something like "List my recent Bot9 transactions." If the MCP tools are loaded correctly, Cursor will call the Bot9 tools automatically. You can also check Settings → MCP for a green status indicator.

.cursor/mcp.json

{
  "mcpServers": {
    "bot9-mcp": {
      "url": "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
    }
  }
}

Get your connection token →

Independent Platform Disclaimer: Vinkius is an independent platform and is not affiliated with, endorsed by, sponsored by, verified by, or otherwise authorized by Bot9. All third-party trademarks, logos, and brand names are the property of their respective owners. Their use on this website is strictly for informational purposes to identify service compatibility and interoperability.

Why Choose Vinkius

Vinkius connects your tools to AI with real-time monitoring and automatic cost savings — all from one dashboard.

Connect Bot9 now

Real-time monitoring

Live

visibility into every interaction

Connect your favorite tools to your AI and see exactly what's happening — every request, every response, in real time.

Built-in savings

60%

lower AI costs

Vinkius compresses data between your apps and your AI automatically. Lower bills every month — no configuration required.

Single dashboard

One

place for every integration

Every tool your AI connects to, managed from a single screen. One account, complete control.

Common questions about Bot9 MCP in Cursor

Add the Bot9 MCP server setup to your `.cursor/mcp.json` file in your project root or your global settings. Once configured, enable Agent mode in your Cursor chat to let the editor invoke the tools.

Yes. You can ask the Cursor agent to create a bot for you, and it will run the `create_bot` tool with your specified parameters, returning the new bot's ID instantly.

No. The server exposes pre-built tools that Cursor understands out of the box. You write plain English prompts, and the agent translates them into tool calls.

Ask the agent to show active threads. It uses `list_conversations` to retrieve the active sessions and can pull individual transcripts using the conversation history tool.

All conversation logs, chatbot configurations, and training URLs are handled through our secure MCP gateway in V8 sandboxes. Your data is never cached or used for model training, keeping your customer support records safe.

Use it with your favorite AI tools

Connect this server to Cursor, Claude, VS Code, and more.

OpenAI Agents SDK sdk-python

Google ADK sdk-python

Pydantic AI sdk-python

Vercel AI SDK sdk-typescript