How to Use the Hive AI MCP in Windsurf

Q: How do I connect the Hive AI MCP Server to Windsurf?

Add the server details to your /.codeium/windsurf/mcpconfig.json file under the mcpServers key. You can also use the Cascade settings UI to configure the connection. Click refresh in the panel to discover the tools.

Let Windsurf Cascade auto-moderate your app's media assets and text directly from your IDE.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Hive AI MCP to Windsurf

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

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Real-time content filtering in Windsurf

The `moderate_text` tool verifies user-generated strings against your safety policies before they hit your database. Unmoderated content kills platforms. You don't want toxic comments sitting in production while you wait for a batch job. Cascade reads your schema, grabs the text fields, and fires them off for inspection. If you handle profile pictures, the `moderate_image` tool takes a public URL and returns a safety score instantly. Windsurf chains these two operations. You set the policy goal, and Cascade builds the verification loop without asking for permission at every step.

Chain async media moderation

Async video requires patience, which is why the `moderate_video_async` tool returns a task ID instead of making your agent hang. Video files take time to process. You pass the media URL, get the ID, and move on to other tasks. Cascade handles the waiting game by polling `get_async_task_status` in the background. Once the job finishes, it calls `get_async_task_result` to pull the final moderation payload. You get the complete workflow executed automatically, saving you from writing custom polling logic.

Spot synthetic content with this MCP Server

The `detect_ai_generated_image` tool exposes exactly what created a specific file, flagging Midjourney or DALL-E artifacts. Fake profile photos ruin platform trust. You feed the image URL to the server, and it returns a probability score. Text is harder, but `detect_ai_generated_text` analyzes blocks of copy for LLM signatures. Cascade can scan an entire directory of user submissions, run the detection tools, and output a CSV of flagged accounts. Bottom line: you stop synthetic spam before it scales.

Setup guide

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

mcp_config.json

{
  "mcpServers": {
    "hive-ai-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 Hive AI. 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 Hive AI 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 Hive AI MCP in Windsurf

Add the server details to your ~/.codeium/windsurf/mcp_config.json file under the mcpServers key. You can also use the Cascade settings UI to configure the connection. Click refresh in the panel to discover the tools.

Yes. Cascade can read a directory of files or a database dump, iterate through the records, and pass them to the moderation endpoints automatically. It handles the looping and data aggregation for you.

Yes. The server connects to your specific project configuration. If you have custom classifiers trained on your data, the agent can call them just like the standard models.

No. Your AI client handles the state management. It requests the initial scan, stores the task ID, and checks the status endpoint until the final result is ready.

Windsurf passes your raw text strings and public media URLs directly to the API endpoint. The server processes this payload in memory and discards it immediately after scoring. No user data persists on the local machine.

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