How to Use the Craft.io MCP in Windsurf

Q: Can Windsurf create new Craft.io items automatically?

Yes, Cascade handles creation autonomously. It uses the createitem tool to draft features, epics, or tasks based on your prompts. You just review the final output in your editor.

Let Cascade build your product roadmaps right inside Windsurf. Connect strategy to execution without leaving 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 Craft.io MCP to Windsurf

Create your Vinkius account to connect Craft.io 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 Craft.io with Windsurf

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Map out roadmaps with the Craft.io MCP Server

The Craft.io MCP Server turns your strategy into actionable items. You tell Windsurf to outline a new product phase, and the agent takes over. It grabs your current workspace context using `list_workspaces` and pulls the active roadmap via `get_portfolio`. Cascade then chains these planning actions together. It reviews the existing structure, then automatically drafts new epics and features by firing `create_item` repeatedly. You just watch the roadmap build itself in real time.

Pull competitor intel directly into your editor

The server brings live market intelligence directly into your editor. When you need context for a new feature, Cascade triggers `get_company_competitors` to find who else is building similar tools. Then it digs deeper into the financial health of those rivals. Calling `get_company_financials` and `get_company_news` gives you a clear picture of their market position. The agent drops this raw data right into your planning document.

Audit your product backlog autonomously

Managing your product backlog happens autonomously with this integration. You can ask Windsurf to clean up your product hierarchy, and Cascade will map out the entire tree. It runs `list_items` to grab everything currently sitting in the queue. Finding specific details takes seconds instead of minutes. If a ticket looks stale, the agent hits `get_item` to pull the full description and status. It then generates a markdown report of what needs your attention.

Setup guide

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

mcp_config.json

{
  "mcpServers": {
    "craftio-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 Craft.io. 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 Craft.io 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 Craft.io MCP in Windsurf

Open your MCP panel and click the Marketplace tab for a one-click install. You can also edit your `mcp_config.json` manually if you prefer managing the configuration file. Cascade will automatically discover the tools once connected.

Yes, Cascade handles creation autonomously. It uses the `create_item` tool to draft features, epics, or tasks based on your prompts. You just review the final output in your editor.

Context switching breaks focus. Bringing this data into your IDE means Cascade can read your codebase and your product roadmap at the same time. It links your actual code directly to the planned strategy.

The agent calls specific lookup tools to grab that information. Asking about your organization triggers `get_company` and `get_company_employees`. Cascade then formats that data directly into your active workspace.

Vinkius isolates your connection completely. When you query company financials or roadmap details, the request runs through a zero-trust V8 Isolate Sandbox. The session is ephemeral, meaning no data persists after your query 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