How to Use the Assembled MCP in Windsurf

Q: What happens when Assembled fails to connect in Windsurf?

Cascade will usually run getaccountcheck to diagnose the issue. If the token is invalid or expired, the agent will tell you to update your authentication credentials.

Connect Windsurf to your support workforce. Cascade pulls live scheduling data and builds staffing reports without making you click through menus.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Assembled MCP to Windsurf

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

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Map Your Support Org in Windsurf

`list_users` and `list_teams` pull your exact workforce structure directly into the IDE. Cascade reads this data to understand exactly who reports where across your customer service department. You skip the manual org chart exports. The agent uses `list_queues` to match those teams to specific support channels, letting you build routing logic based on actual operational setups.

Analyze Agent Schedules Autonomously

`list_schedules` gives your AI client historical and upcoming shift data for any time range. Give Cascade a goal to find staffing gaps, and it pulls the shifts, compares them to expected coverage, and outputs the result. It handles the multi-step process automatically. After checking shifts, it can run `list_agent_states` to see who is actually logged in right now versus who was scheduled to work.

Build Forecast Models with MCP Server Data

`list_forecasts` extracts contact volume predictions straight from Assembled. Cascade chains this together with your existing codebase to auto-generate capacity planning scripts or update dashboards. Just tell Windsurf to update the staffing model. The agent verifies the connection with `get_account_check`, grabs the forecast numbers, and writes the necessary Python or TypeScript code.

Setup guide

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

mcp_config.json

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

Open the MCP panel and click the Marketplace tab for a one-click install. You can also edit `~/.codeium/windsurf/mcp_config.json` manually if you prefer managing the config file.

This server only reads data. Cascade can pull current assignments using `list_queues` and `list_teams`, but it cannot push changes back to your workforce management system.

Cascade will usually run `get_account_check` to diagnose the issue. If the token is invalid or expired, the agent will tell you to update your authentication credentials.

You avoid writing boilerplate code. Windsurf discovers the tools instantly upon connection, letting Cascade query agent states and schedules without you writing a single fetch request.

Vinkius runs this MCP server inside a V8 Isolate Sandbox. Agent schedules, forecast volumes, and user lists stay isolated in an ephemeral environment that destroys itself after the session ends.

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