How to Use the Aha! MCP in Windsurf

Q: How does Cascade read my Aha! roadmap inside Windsurf?

The agent uses the listreleases and listfeatures tools to pull your data directly into the chat. It formats the raw JSON into a readable timeline so you know exactly what to build next.

Connect Aha! to Windsurf and let Cascade chain your product ideas into actionable feature requests autonomously.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Aha! MCP to Windsurf

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

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Turn user feedback into planned features

Cascade reads your raw user interview transcripts and pushes them directly to your Aha! backlog. It pulls existing roadmap context using `list_releases` to see where a new concept fits into the broader company vision. Instead of manually logging tickets, you just tell Windsurf to process the notes. The agent fires `create_idea` automatically, linking the raw text to your product strategy without making you approve every single step.

Windsurf MCP Server roadmap analysis

Connecting this MCP Server gives your IDE direct access to your Aha! strategic backlog. When you start planning a sprint, Cascade runs `list_features` to pull the exact requirements right into your editor. You never have to switch tabs to check what a specific ticket actually means. Windsurf triggers `get_feature` to grab the acceptance criteria, letting you write the code immediately while the context is fresh.

Autonomous release planning

Product managers usually spend hours cross-referencing Aha! ideas against upcoming launches. Cascade does that math for you by executing `list_ideas` and comparing the output against scheduled milestones. The agent builds a proposed timeline right in your workspace. It sees exactly what features are tied to which release, keeping your development work aligned with the actual business goals.

Setup guide

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

mcp_config.json

{
  "mcpServers": {
    "aha-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 Aha!. 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 Aha! 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 Aha! MCP in Windsurf

Open Settings, navigate to Cascade, and find the server configuration UI. Add the Vinkius endpoint URL under the mcpServers key, then hit Refresh in the panel.

Yes. Cascade can read your local text files or conversation history and trigger the `create_idea` tool. You just tell it to capture the feedback and it handles the API call.

The agent uses the `list_releases` and `list_features` tools to pull your data directly into the chat. It formats the raw JSON into a readable timeline so you know exactly what to build next.

No custom code is required. Windsurf auto-discovers the available tools the moment you connect the server. You just ask questions in plain English.

Vinkius runs your server in an ephemeral V8 Isolate Sandbox. Your strategic goals, feature descriptions, and release schedules pass through a zero-trust environment that destroys itself after the request finishes.

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