How to Use the Halo Security MCP in Windsurf

Q: How do I connect the Halo Security MCP Server to Windsurf?

Open your mcpconfig.json file in Windsurf or use the Settings UI to add the server configuration. Cascade automatically discovers these security tools on connection.

Q: Can Cascade run automated security scans using Halo Security in Windsurf?

Yes, Cascade autonomously runs triggerscan whenever it detects changes to your targets. It monitors the scan progress via listscans and alerts you when the security assessment finishes.

Q: How do I check for active vulnerabilities in my codebase?

Ask Cascade to run listissues to pull all active vulnerabilities. It uses getissue to fetch the specific payload details and write code changes to fix the root cause.

Track your external attack surface autonomously in Windsurf using live security scanning and asset discovery tools.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Halo Security MCP to Windsurf

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

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Headless Asset Discovery with Windsurf

The `add_target` tool registers new domains or IP addresses for active tracking using this MCP Server. Cascade scans your infrastructure, finds new subdomains, and feeds them directly into the monitoring queue without waiting for manual input. Once registered, the `list_targets` tool pulls the active inventory list so your agent can verify which assets are currently monitored. Your agent uses this list to map your entire external perimeter and flag untracked systems instantly.

Automated Port and Technology Auditing

The `list_open_ports` tool exposes all active network services running on your public-facing assets. Cascade analyzes these open ports alongside `list_technologies` to identify outdated software stacks and deprecated web frameworks before they become liabilities. Your agent correlates this raw service data to build an accurate profile of your software footprint. It spots running services that violate your company security policies and flags them for immediate teardown.

Continuous Vulnerability Triage and Scanning

The `trigger_scan` tool kicks off immediate vulnerability assessments on any active target in your inventory. When Cascade detects a new deployment, it automatically runs this tool to search for fresh security gaps. It then calls `list_issues` to pull the latest security findings and categorizes them by risk level. Your agent chains this with `get_issue` to extract remediation steps and write the necessary patches on the spot.

Setup guide

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

mcp_config.json

{
  "mcpServers": {
    "halo-security-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 Halo Security. 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 Halo Security 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 Halo Security MCP in Windsurf

Open your `mcp_config.json` file in Windsurf or use the Settings UI to add the server configuration. Cascade automatically discovers these security tools on connection.

Yes, Cascade autonomously runs `trigger_scan` whenever it detects changes to your targets. It monitors the scan progress via `list_scans` and alerts you when the security assessment finishes.

Yes, this MCP integration lets Windsurf query your live targets and add new ones. Your agent uses `list_dns_records` and `add_target` to find and monitor subdomains dynamically.

Ask Cascade to run `list_issues` to pull all active vulnerabilities. It uses `get_issue` to fetch the specific payload details and write code changes to fix the root cause.

This server only routes API calls to fetch your open ports, DNS records, and vulnerability details. Vinkius runs the connection in an isolated sandbox, meaning your API tokens and raw scan results never persist on external servers.

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