How to Use the GPTBots MCP in Windsurf

Q: How do I connect the GPTBots MCP server to Windsurf?

Open your /.codeium/windsurf/mcpconfig.json file and add the server configuration under the mcpServers key. Alternatively, go to Settings, select Cascade, and use the MCP Servers UI to add the endpoint.

Q: How does Windsurf display schemas retrieved from GPTBots?

When Cascade calls listdatabases through the MCP Server, it parses the returned JSON structure. The IDE then displays these database tables directly in your chat panel as structured context.

Drive your GPTBots agents and manage knowledge bases directly from Windsurf using Cascade's autonomous multi-step execution.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect GPTBots MCP to Windsurf

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

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Run workflows and track execution status

`trigger_workflow` starts automated backend processes directly inside your Windsurf environment. Cascade initiates these tasks and automatically checks their progress using `query_workflow` without requiring you to manually poll for updates. This setup lets your IDE monitor long-running background tasks. When a workflow finishes, Cascade reads the output and immediately proceeds with the next step in your development pipeline.

Update your knowledge bases on the fly

`create_knowledge_document` sends local code files, Markdown documentation, or API specifications straight into your remote vector store. Cascade reads your workspace files, identifies outdated documentation, and pushes the fresh content to keep your agent's context window accurate. You can also use `list_knowledge_documents` to audit what files already exist in your repository via the MCP server. Doing this prevents duplicate uploads and ensures your agent relies on the exact files you intended.

Manage live chat histories inside Windsurf

`list_conversations` fetches recent active sessions from your live bot deployments. Cascade uses this list to pinpoint failing user chats and pulls down the exact message logs with `get_conversation` to help you debug logical errors. If you need to test a quick fix, `send_bot_message` lets you talk to the agent directly inside the IDE. You see exactly how the model responds to your updated prompts before deploying.

Setup guide

Set up GPTBots 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 GPTBots 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 GPTBots payment history." If connected, Cascade will call the GPTBots tools directly. You will see a green dot next to the server name in the MCP panel.

mcp_config.json

{
  "mcpServers": {
    "gptbots-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 GPTBots. 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 GPTBots 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 GPTBots MCP in Windsurf

Open your `~/.codeium/windsurf/mcp_config.json` file and add the server configuration under the `mcpServers` key. Alternatively, go to Settings, select Cascade, and use the MCP Servers UI to add the endpoint.

Yes, Cascade handles multi-step operations on its own. When you ask it to fix a workflow, it will call `trigger_workflow` and then poll `query_workflow` to verify completion without needing intermediate prompts.

When Cascade calls `list_databases` through the MCP Server, it parses the returned JSON structure. The IDE then displays these database tables directly in your chat panel as structured context.

No, Vinkius handles the underlying credentials. You only need a single endpoint token in your configuration file to access all eight tools on this MCP Server.

Your conversational transcripts and database schemas remain isolated within the Vinkius V8 sandbox. Data transmits over encrypted TLS tunnels, and ephemeral instances destroy all session logs immediately after execution.

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