How to Use the Hub Planner MCP in Cursor

Q: How do I configure the Hub Planner MCP Server in Cursor?

Create a .cursor/mcp.json file in your project root or add it to your global settings. Define the Hub Planner server under the mcpServers key with your API token to start using it in Agent mode.

Q: Can Cursor help me build a custom dashboard for Hub Planner?

Yes, it can. By calling listbookings and listprojects, Cursor pulls the live data you need to design, write, and test your dashboard components with real payloads.

Q: Can I query Hub Planner team structures using Cursor?

You can. The agent uses listteams to fetch your current organization chart, allowing you to write code that maps developers to their respective departments.

Write code against live Hub Planner data. Let Cursor query bookings and projects directly as you build custom tools.

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 Cursor

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

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Inject Live Hub Planner Data via MCP Server

The `list_projects` tool pulls live Hub Planner project data directly into your Cursor workspace. This lets your Cursor agent query live production data while you write code instead of relying on stale mock files. You can use `get_me` to verify your Hub Planner API credentials and user permissions directly in Cursor. This eliminates the guesswork of testing endpoints because Cursor displays real Hub Planner responses immediately.

Debug Resource Queries in Real Time

The `list_bookings` tool lets you debug scheduling logic using real Hub Planner data in Cursor. When you write functions to calculate team capacity, Cursor executes this query alongside `list_resources` to provide real Hub Planner payloads. If you need to handle edge cases, ask your Cursor agent to fetch `list_unassigned` Hub Planner tasks. This gives you immediate examples of empty states and unallocated bookings to test your Hub Planner error handling.

Filter API Payloads by Metadata

The `list_tags` tool discovers metadata classifications directly inside Cursor. Your Cursor agent uses this information to determine how Hub Planner resources and projects are classified in your account before you write filtering logic. This keeps your Cursor application fast and prevents unnecessary Hub Planner API overhead. You can also call `list_clients` to map client-specific Hub Planner datasets during active development.

Setup guide

Set up Hub Planner 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 Hub Planner 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 Hub Planner transactions." If the MCP tools are loaded correctly, Cursor will call the Hub Planner tools automatically. You can also check Settings → MCP for a green status indicator.

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

Create a `.cursor/mcp.json` file in your project root or add it to your global settings. Define the Hub Planner server under the `mcpServers` key with your API token to start using it in Agent mode.

Yes, it can. By calling `list_bookings` and `list_projects`, Cursor pulls the live data you need to design, write, and test your dashboard components with real payloads.

You can. The agent uses `list_teams` to fetch your current organization chart, allowing you to write code that maps developers to their respective departments.

The editor makes direct calls to the endpoints as needed. If you are running heavy queries like `list_events`, you should implement local caching in your code to avoid hitting rate limits during testing.

Absolutely. Your credentials, user profiles, and project bookings are handled locally on your machine or through a secure MCP Server endpoint. No third party gets access to your resource lists or client details.

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