How to Use the Structured MCP in Windsurf

Q: How do I list all my structured plans using Windsurf?

Call the listplans tool. It immediately returns an array containing titles and IDs for every plan you've created in Structured.

Q: If I need to see details on one specific task in Structured with Windsurf, what tool do I use?

Just run gettaskdetails and pass the necessary task ID. You'll get all the granular information you need about that single item.

Q: Can I update a task using Structured and Windsurf? What happens?

Yes, use updatetask. This lets you change existing details without having to delete and recreate the whole entry. It keeps your MCP Server data current.

Q: Is there a way to check my user profile using Structured and Windsurf?

Yep, run getuserprofile. This retrieves the necessary details about the account connected to the MCP Server, ensuring permissions are correct for future actions.

Automate your planning cycles with Windsurf. Get tasks done, period.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers — Included with Plan

Connect Structured MCP to Windsurf

Create your Vinkius account to connect Structured to Windsurf — we handle the hosting, security, and runtime updates so you don't have to. No server setup required.

GDPR Included with Plan

Setup Structured with Windsurf

Ask AI about this MCP

ChatGPT

Claude

Perplexity Vinkius runs on Gemini

Gemini

Grok

Manage Plans and Tasks via MCP Server

Windsurf can handle the full lifecycle of structured plans. You'll use `list_plans` to see everything and then `get_plan_details` when you need deep context on a specific plan. Need to add something? Call `create_plan` to start a new project structure or `create_task` to drop in an immediate action item with an optional start time.

Update and Delete Tasks for Windsurf

Don't forget the maintenance side. If a task changes, run `update_task` to adjust its title or details. For when things are truly finished, `delete_task` permanently removes an item—it's irreversible. These functions keep your MCP Server clean and accurate, making sure what you think is done actually disappears.

Access User Data with Windsurf

The agent can fetch key user information using `get_user_profile`. This lets other parts of your workflow know who's responsible for the tasks or plans. You also have direct access to `list_tasks` and `list_plans`, giving you a quick overview of everything that's currently tracked in Structured.

Setup guide

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

mcp_config.json

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

Call the `list_plans` tool. It immediately returns an array containing titles and IDs for every plan you've created in Structured.

This server deals with structured tasks, which include a title and optional start time. It also manages plans, which are containers for those tasks.

Just run `get_task_details` and pass the necessary task ID. You'll get all the granular information you need about that single item.

Yes, use `update_task`. This lets you change existing details without having to delete and recreate the whole entry. It keeps your MCP Server data current.

Yep, run `get_user_profile`. This retrieves the necessary details about the account connected to the MCP Server, ensuring permissions are correct for future actions.

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