How to Use the Bot9 MCP in Windsurf

Q: How do I add Bot9 to Windsurf?

Open your mcpconfig.json file in /.codeium/windsurf/ and add the Bot9 MCP Server configuration under the mcpServers key. Save the file and Cascade will immediately discover the eight support tools.

Q: Can Cascade train Bot9 bots autonomously?

Yes, Cascade can chain the adddatasource and listdatasources tools on its own. You just tell it to update a bot with a new documentation URL, and it handles the API calls.

Q: How do I check active user chats?

Ask Cascade to list your active support sessions. It runs listconversations and getconversationhistory to show you exactly what your customers are asking.

Let Cascade build, train, and test your support bots autonomously inside Windsurf.

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 Windsurf

Create your Vinkius account to connect Bot9 to Windsurf 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 Windsurf

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Feed data to your bots directly from Windsurf

The `add_data_source` tool lets Cascade feed new URLs straight into your Bot9 knowledge base. Cascade reads your local docs, finds the outdated parts, and pushes the new links to your bot without you copying and pasting anything. You can verify what your bot already knows by running `list_data_sources`. Cascade checks the current training index, compares it with your workspace files, and fills in the gaps on its own.

Build and track support bots with this MCP Server

The `create_bot` tool instantiates new customer service agents directly from your editor. Cascade sets up the bot, configures its initial settings, and then calls `list_bots` to make sure it shows up in your active roster. If you need to check a specific agent's setup, Cascade uses `get_bot` to pull the exact configuration. This lets your agent debug bot behavior side-by-side with your local code changes.

Inspect live support chats in Cascade

The `list_conversations` tool fetches active customer chats so our MCP connection can analyze where your support bots are struggling. It pulls the conversation IDs directly into your Windsurf panel. Once Cascade spots a stuck user, it runs `get_conversation_history` to read the chat log. Your agent can even test a fix in real-time by using `send_message` to see how the bot responds to a tricky customer question.

Setup guide

Set up Bot9 MCP in Windsurf

Prerequisites

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

1

Open MCP configuration

Click the Cascade assistant icon in the sidebar, then click the hammer icon (🔨) at the top of the panel. Select "Configure" to open ~/.codeium/windsurf/mcp_config.json.
2

Add the Bot9 MCP

Paste the JSON snippet shown on the right into the mcpServers object. Replace [YOUR_TOKEN_HERE] with your endpoint token from cloud.vinkius.com.
3

Refresh MCPs

Go back to the hammer icon (🔨) in Cascade and click "Refresh". Windsurf will detect the new server. No full restart is needed — the connection is hot-reloaded.
4

Verify in Cascade

Start a new Cascade conversation and ask something like "Show my Bot9 payment history." If connected, Cascade will call the Bot9 tools directly. You will see a green dot next to the server name in the MCP panel.

mcp_config.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 Windsurf

Open your `mcp_config.json` file in `~/.codeium/windsurf/` and add the Bot9 MCP Server configuration under the `mcpServers` key. Save the file and Cascade will immediately discover the eight support tools.

Yes, Cascade can chain the `add_data_source` and `list_data_sources` tools on its own. You just tell it to update a bot with a new documentation URL, and it handles the API calls.

Yes, you can talk to your bots directly from the Windsurf chat. Cascade uses the `send_message` tool to pass prompts to your bot and print the replies inside your IDE.

Ask Cascade to list your active support sessions. It runs `list_conversations` and `get_conversation_history` to show you exactly what your customers are asking.

Your customer conversations and raw training URLs stay secure because Vinkius runs this MCP Server in an isolated V8 sandbox. No raw credentials or database details are stored on your local disk.

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