How to Use the Structured MCP in Cursor

Q: How does Cursor use Structured to manage tasks?

The MCP Server lets your agent call listtasks and gettaskdetails. This means the live data from Structured feeds directly into the code you're writing, eliminating mock data issues.

Q: Can I get a user profile using Structured in Cursor?

Yes. The getuserprofile tool retrieves your current user details, allowing your running script to use that context for authentication or logic checks.

Q: Which tools are available for structured data handling with Cursor?

You can manage tasks using createtask, update them via updatetask, and delete old ones with deletetask. All these actions provide live context to your code.

Q: Does the MCP Server support reading existing plans in Structured with Cursor?

You can retrieve plan details using getplandetails or get a full list by calling listplans. This data is immediately available for your coding context.

Write code that uses live planner data directly in Cursor.

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 Cursor

Create your Vinkius account to connect Structured to Cursor — 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 Cursor

Ask AI about this MCP

ChatGPT

Claude

Perplexity Vinkius runs on Gemini

Gemini

Grok

Fetch Plan Details for Live Coding

Need to calculate something based on a specific routine? You can call `get_plan_details` and inject the resulting JSON into your code block. This gives you live data—not stubs—to work with.

Manipulate Tasks Using Cursor

Want to build a script that adds reminders? Use `create_task` to define new tasks, specifying titles and start times directly in your agent call. You'll then write the code that uses those parameters.

List All Structured Plans in Your Code

You can get a complete list of structured plans by invoking `list_plans`. This function returns an array you can iterate over immediately, letting your agent process all the necessary data points for your application.

Setup guide

Set up Structured MCP in Cursor

Prerequisites

Cursor installed (macOS, Windows, or Linux)
Active Vinkius subscription with a valid endpoint token

1

Open MCP Settings

Go to Cursor Settings → MCP or open the Command Palette (Cmd+Shift+P / Ctrl+Shift+P) and search for "MCP: Add Server".
2

Add the Structured MCP

Cursor will create or open .cursor/mcp.json in your project root. Paste the JSON snippet on the right. Replace [YOUR_TOKEN_HERE] with your endpoint token from cloud.vinkius.com.
3

Enable Agent mode

Open Composer (Cmd+I / Ctrl+I) and switch to Agent mode using the dropdown at the top. MCP tools are only available in Agent mode.
4

Verify the connection

Ask Cursor something like "List my recent Structured transactions." If the MCP tools are loaded correctly, Cursor will call the Structured tools automatically. You can also check Settings → MCP for a green status indicator.

.cursor/mcp.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 Cursor

The MCP Server lets your agent call `list_tasks` and `get_task_details`. This means the live data from Structured feeds directly into the code you're writing, eliminating mock data issues.

Yes. The `get_user_profile` tool retrieves your current user details, allowing your running script to use that context for authentication or logic checks.

You can manage tasks using `create_task`, update them via `update_task`, and delete old ones with `delete_task`. All these actions provide live context to your code.

You can retrieve plan details using `get_plan_details` or get a full list by calling `list_plans`. This data is immediately available for your coding context.

This server handles task titles, start times, user profile details, and the structural metadata required to organize plans within Structured.

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