How to Use the Workast MCP in Windsurf

Q: How can I search for project status using Workast and Windsurf?

You just tell your agent what you need. It calls listspaces to find the right projects, then uses listtasks within those spaces to pull a live count of open items.

Q: How do I check my profile status using Workast and Windsurf?

You invoke the getaccountprofile tool in your agent prompt. It pulls all your current account details—like name, role, and last login—and shows them directly to you.

Q: Does Workast integrate with my existing team setup via Windsurf?

Yes. You can use the getteaminfo tool to pull the current structure of your company or department into your agent's context immediately.

Q: Is there a way to list all available Workast spaces using Windsurf?

You call listspaces. It gives you an array of every project container you have access to, so you know exactly where the work is sitting before you start.

Automate team collaboration and project tracking goals in Windsurf, effortlessly.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Workast MCP to Windsurf

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

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Automated Space & Task Management

You ask Windsurf to find all active projects related to a specific user, and it runs multiple actions automatically. First, it uses `list_spaces` to map out every possible project area. Then, it filters down by calling `get_user`, ensuring only relevant spaces are considered before gathering the full scope of work. It then compiles everything using `list_tasks` across those selected areas. You get a complete status report without ever having to prompt for the next step.

User and Team Data Aggregation

Need an overview of who's on board? Windsurf gathers all necessary team data in one go. It first calls `list_users` to get a full roster of available accounts. Next, it pulls specific details by calling `get_user`, allowing you to compare roles and permissions against the broader context. This helps you check out who reports to whom, or if someone has been added since your last login. It builds team knowledge without manual API calls.

Full Project Lifecycle Control

Windsurf handles full project updates when the status changes. Tell it to update a task across all spaces for a given user, and it runs `get_account_profile` first to verify permissions. Then, it uses `list_spaces` to find every container that holds work. It executes `update_task` on each item found. You just define the goal—like 'mark everything overdue'—and Windsurf handles the complex sequence of reading and writing data.

Setup guide

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

mcp_config.json

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

You just tell your agent what you need. It calls `list_spaces` to find the right projects, then uses `list_tasks` within those spaces to pull a live count of open items.

This MCP Server handles account profiles, user details, team information, and specific task records. You're dealing with structured project management metadata.

You invoke the `get_account_profile` tool in your agent prompt. It pulls all your current account details—like name, role, and last login—and shows them directly to you.

Yes. You can use the `get_team_info` tool to pull the current structure of your company or department into your agent's context immediately.

You call `list_spaces`. It gives you an array of every project container you have access to, so you know exactly where the work is sitting before you start.

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