How to Use the Cube.dev MCP in Windsurf
Use the Cube.dev MCP Server to let Windsurf Cascade build data-aware components by querying your semantic layer directly.
Works with every AI agent you already use
…and any MCP-compatible client
Connect Cube.dev MCP to Windsurf
Create your Vinkius account to connect Cube.dev 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.
Query your data models inside Windsurf
Cascade uses `load_query` to pull live metrics from your semantic layer without writing boilerplate. It turns your natural language request into the specific JSON payload your API expects. You avoid manual context switching. The agent grabs the results and builds your UI components based on real-time data structures.
Debug generated SQL with Windsurf
When your dashboard shows unexpected numbers, use `get_sql` to inspect what the engine actually sent to your database. It shows you the raw query translation for any complex view. Windsurf reads these logs to fix syntax errors before they hit your production logs. You get a clear path from a broken chart to a working query.
Manage pre-aggregations via Windsurf
Trigger `trigger_pre_aggregation_job` when you need fresh data for a critical report. You see the job status update in real-time using `get_pre_aggregation_job_status`. This keeps your analytics performant without leaving the editor. Cascade handles the polling so you focus on the frontend logic.
Set up Cube.dev 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 Cube.dev 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 Cube.dev payment history." If connected, Cascade will call the Cube.dev tools directly. You will see a green dot next to the server name in the MCP panel.
{
"mcpServers": {
"cubedev-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 Cube.dev. 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 Cube.dev MCP in Windsurf
Use it with your favorite AI tools
Connect this server to Cursor, Claude, VS Code, and more.
Start using the Cube.dev MCP today
We host it, we monitor it, we maintain it. You just paste one token.
