How to Use the airfocus MCP in Windsurf

Q: How do I set up the airfocus MCP Server in Windsurf?

Edit your /.codeium/windsurf/mcpconfig.json file to add the server under the mcpServers block, or use the Settings UI under Cascade. Once added, click Refresh in the MCP panel to let Cascade auto-discover the six roadmap tools.

Q: Can Cascade create new roadmap items in airfocus directly from my Windsurf workspace?

Yes. Cascade uses the createairfocusitem tool to build new cards on your board. It can parse your current code files, extract a feature request, and post it to your workspace automatically.

Q: How does Windsurf handle airfocus custom fields when updating items?

Cascade calls listairfocusfields to read the exact schema of your workspace. It then uses updateairfocusitem to apply precise values to those fields based on your code context.

Connect this MCP Server to let Cascade run your roadmapping loop inside Windsurf.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect airfocus MCP to Windsurf

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

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Automate roadmap updates inside Windsurf

This MCP Server uses `update_airfocus_item` to let Cascade modify your product roadmap items directly from your current coding context. When Cascade spots a completed feature in your codebase, it initiates a multi-step plan to locate the matching item and update its status instantly. Here's the thing: you don't have to jump back and forth between your editor and your browser. Cascade chains the workspace search, finds the right card, and applies the changes while you focus on writing code.

Map custom fields to your active codebase

This integration relies on `list_airfocus_fields` to pull down the exact scoring criteria and custom fields defined in your workspace. Cascade reads these fields to map code metrics or complexity estimates directly to your product management board. Instead of manually guessing how a feature aligns with your roadmap, your agent pulls the exact structure of your airfocus workspace. It keeps your development effort estimates aligned with your strategic metrics.

Audit workspace items on the fly

The server uses `list_airfocus_workspaces` and `list_airfocus_items` to inspect your active product boards directly from the Cascade panel. Your agent scans your entire workspace to find orphaned tasks or unassigned feature requests. Cascade executes these calls in sequence to build a clean list of what needs your attention. It gives you a clear picture of your backlog without requiring you to open a single web page.

Setup guide

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

mcp_config.json

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

Edit your ~/.codeium/windsurf/mcp_config.json file to add the server under the mcpServers block, or use the Settings UI under Cascade. Once added, click Refresh in the MCP panel to let Cascade auto-discover the six roadmap tools.

Yes. Cascade uses the `create_airfocus_item` tool to build new cards on your board. It can parse your current code files, extract a feature request, and post it to your workspace automatically.

Cascade calls `list_airfocus_fields` to read the exact schema of your workspace. It then uses `update_airfocus_item` to apply precise values to those fields based on your code context.

This server provides six specific tools for workspace inspection, item creation, item updates, and field retrieval. Your agent combines these tools to manage your roadmap without manual intervention.

Your workspace items and custom fields are processed inside an isolated sandbox environment. Vinkius secures your token and handles the API transport directly, so your product roadmap data never leaks to third parties.

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