How to Use the Botsonic MCP in Cursor

Q: How do I install the Botsonic MCP Server in Cursor?

Add the server configuration to your project's .cursor/mcp.json file. Once saved, your agent will immediately have access to all twelve support tools.

Q: Can I use Botsonic to debug chat flows inside Cursor?

Yes. You can query live chat logs using getconversation to see exactly where a customer flow failed, then fix the code right in your editor.

Q: Can Cursor help me export leads captured by Botsonic?

Yes. Your agent can run listleads to pull captured customer contact details and format them into a CSV or JSON file inside your workspace.

Q: How do I verify if my bot is online?

Ask your agent to run checkbotsonicstatus. It will quickly ping the API to confirm your connection is active and working.

Code custom support workflows and query Botsonic analytics directly 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 Botsonic MCP to Cursor

Create your Vinkius account to connect Botsonic 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 Botsonic with Cursor

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Build support features with live Botsonic data

Stop writing code against fake API responses by pulling actual bot configurations with `get_bot`. When you write code in Cursor, your agent runs this tool along with `list_bots` to pull real configuration data straight into your active file. This means you build features using your actual production setup. You write cleaner code because you see exactly how your bots are configured in real-time.

Code analytics dashboards with Cursor and MCP

Build custom reporting tools by pulling live performance data with `get_bot_analytics`. Your agent grabs actual usage metrics and structures them into your dashboard code. You can also list and inspect active user sessions. Use `list_conversations` and `get_conversation` to write test suites or debug features with real chat logs.

Automate bot deployments in your editor

Write scripts to manage your support bots programmatically using `create_bot`. This MCP Server lets your agent trigger bot creation and run `update_bot` to set up new environments directly from your terminal or editor chat. Keep your bot's training files in sync with your codebase. Run `add_knowledge_url` and `list_knowledge_base` to update your bot's data sources whenever you deploy new documentation.

Setup guide

Set up Botsonic 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 Botsonic 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 Botsonic transactions." If the MCP tools are loaded correctly, Cursor will call the Botsonic tools automatically. You can also check Settings → MCP for a green status indicator.

.cursor/mcp.json

{
  "mcpServers": {
    "botsonic-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 Botsonic. 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 Botsonic 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 Botsonic MCP in Cursor

Add the server configuration to your project's `.cursor/mcp.json` file. Once saved, your agent will immediately have access to all twelve support tools.

Yes. You can query live chat logs using `get_conversation` to see exactly where a customer flow failed, then fix the code right in your editor.

Yes. Your agent can run `list_leads` to pull captured customer contact details and format them into a CSV or JSON file inside your workspace.

Ask your agent to run `check_botsonic_status`. It will quickly ping the API to confirm your connection is active and working.

All bot analytics and conversation logs remain protected. The server acts as a pass-through to your secure account, running inside a zero-trust sandbox so your business metrics are never exposed.

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