How to Use the AdsWizz MCP in Windsurf
Let Windsurf Cascade autonomously pull your AdsWizz audio campaign metrics and build reporting components in one go.
Works with every AI agent you already use
…and any MCP-compatible client
Connect AdsWizz MCP to Windsurf
Create your Vinkius account to connect AdsWizz 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.
Analyze campaigns inside Windsurf
Cascade pulls the active audio ads directly into your workspace. Running `list_campaigns` grabs everything currently active in your account. You do not have to switch context. The agent checks the IDs and moves to the next step without asking for permission.
Map audio ad inventory
Finding where your podcast spots run takes seconds. The `list_zones` tool fetches every available stream and podcast slot. Cascade reads this MCP inventory data directly into your editor. It structures the JSON output into whatever format your current project requires.
Pull performance metrics
Stop manually exporting CSVs from the dashboard. Just tell your MCP agent to run `get_audio_performance` for a specific date range. It fetches the listen-through rates and impressions. The `get_campaign` command pulls the specific ad details to give you a complete picture of what is working.
Set up AdsWizz 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 AdsWizz MCP
Paste the JSON snippet shown on the right into the
mcpServersobject. 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 AdsWizz payment history." If connected, Cascade will call the AdsWizz tools directly. You will see a green dot next to the server name in the MCP panel.
{
"mcpServers": {
"adswizz-mcp": {
"url": "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
}
}
}Independent Platform Disclaimer: Vinkius is an independent platform and is not affiliated with, endorsed by, sponsored by, verified by, or otherwise authorized by AdsWizz. 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.
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 AdsWizz MCP in Windsurf
Use it with your favorite AI tools
Connect this server to Cursor, Claude, VS Code, and more.
Start using the AdsWizz MCP today
We host it, we monitor it, we maintain it. You just paste one token.
