How to Use the Hub Planner MCP in Windsurf

Q: Will this work with custom booking categories?

Yes. The listcategories tool fetches whatever custom categories you configured. The agent reads that list and groups the capacity data accordingly.

Connect Hub Planner to Windsurf and let Cascade autonomously build capacity reports and manage resource schedules.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Hub Planner MCP to Windsurf

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

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Let Windsurf chain resource queries

The Hub Planner MCP Server exposes your agency's capacity data directly to Cascade. You tell Windsurf to find out who is free next week, and the agent automatically pulls the required context. It fires off `list_resources` to get the team roster and immediately cross-references it using `list_bookings`. Cascade doesn't stop there. If you ask for a utilization breakdown, it chains `list_unassigned` and `list_projects` to figure out exactly where the gaps are. You get a complete picture of your scheduling capacity without clicking through web dashboards or writing custom API scripts.

Map teams to active client work

This MCP Server cuts out the hours project managers spend matching developers to accounts. You can ask your agent to build a markdown table of current assignments, and it will run `list_teams` followed by `list_clients`. The integration pulls the exact mapping of who works for whom. By querying `list_categories` and `list_tags`, the agent filters out internal overhead and focuses strictly on billable hours. You see the exact data you need in seconds.

Track time off and unassigned hours

This integration lets you check vacation schedules right from your editor to avoid booking conflicts. The agent uses `list_events` to pull approved time off and immediately flags overlaps with active project timelines. When a conflict hits, you need a backup plan fast. The agent runs `get_me` to verify your permissions, then uses `list_unassigned` to find pending work that needs coverage. You fix the schedule before the client even notices a delay.

Setup guide

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

mcp_config.json

{
  "mcpServers": {
    "hub-planner-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 Hub Planner. 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 Hub Planner 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 Hub Planner MCP in Windsurf

Open the MCP Server UI under Settings, then Cascade. Add the server details to your mcpServers list and hit the refresh button. You can also edit `~/.codeium/windsurf/mcp_config.json` directly.

No. The current tools are read-only. Cascade can pull schedules using `list_bookings` and check availability, but you still make changes in the main application.

Tags define skill sets and project phases. When Windsurf searches for a specific developer profile, it uses `list_tags` to filter the exact resources you need for a task.

Yes. The `list_categories` tool fetches whatever custom categories you configured. The agent reads that list and groups the capacity data accordingly.

Windsurf runs the MCP Server locally on your machine. When it pulls employee names, PTO from `list_events`, or project assignments, that data stays within your local workspace memory. Vinkius provides an isolated sandbox, meaning your resource rosters never touch a third-party server.

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