# Hub Planner MCP MCP > Hub Planner connects your AI agent to resource management, letting you track team members, equipment, and project schedules. Quickly list all active projects, check bookings for specific people, or find out who's available next quarter. It’s the single source for operational scheduling data. ## Overview - **Category:** productivity - **Price:** Free - **Tags:** resource-allocation, capacity-planning, project-scheduling, time-tracking, team-management ## Description Need to map out a huge project schedule? This MCP connects your AI agent directly to Hub Planner’s core API, giving you immediate visibility into resource allocation. You can list all projects and track how far along they are, or check who's booked up next month. It lets you view client information and manage team member availability without opening ten different tabs. Instead of jumping between project trackers, this MCP pulls the data together so your agent knows exactly which people and pieces of equipment are needed for a given time slot. Using Vinkius makes sure that regardless of whether you're working in Cursor or Claude, your AI client can talk to Hub Planner directly. You simply ask, and it finds the answer. ## Tools ### get_me Retrieves the basic profile information of the currently logged-in user. ### list_bookings Generates a list detailing all current reservations for any specified resource. ### list_categories Shows the defined types or categories used when making bookings. ### list_clients Gathers a comprehensive list of every client associated with your company. ### list_events Retrieves records detailing planned time off or other scheduled events for team members. ### list_projects Lists all active and historical projects tracked in the system. ### list_resources Provides a full inventory list of people, machines, or other physical resources. ### list_tags Fetches a list of general labels used to organize projects and resources. ### list_teams Lists all defined organizational teams within the company structure. ### list_unassigned Finds records of bookings or time slots that have not been assigned to a specific resource. ## Prompt Examples **Prompt:** ``` List all resources in Hub Planner. ``` **Response:** ``` I'll fetch the list of your team members and resources. ``` **Prompt:** ``` Show me active projects. ``` **Response:** ``` I'll retrieve your active project list. ``` **Prompt:** ``` Check bookings for the next 7 days. ``` **Response:** ``` I'll look up the resource bookings for you. ``` ## Capabilities ### View all people and equipment Get a full list of every person, vehicle, or piece of gear in use by the company. ### Track scheduled time off or events Pull records for booked leave days or specific scheduled non-working times. ### Check existing bookings List current resource reservations to see who's busy and when. ### Review project details Retrieve a list of every defined project, helping you understand the scope of work. ### Identify unassigned time slots Flag resources or rooms that currently have no bookings scheduled for them. ## Use Cases ### Launching a new campaign A marketing director needs to know who on the team (list_resources) can dedicate time for the next month. They ask their agent, and it cross-references list_events and list_bookings to give them only genuinely free people. ### Auditing resource usage An operations manager suspects resources are being underused. They run a check using list_unassigned and list_resources to quickly identify which assets or staff members have zero scheduled work time this quarter. ### Client onboarding assessment A salesperson needs to assess the capacity for a new, large client. They use list_clients to confirm details, then check list_projects and list_teams to see if current teams are already over-allocated. ### Conflict resolution Two project managers think they scheduled the same equipment (list_resources) for different dates. Using list_bookings allows them to compare schedules and pinpoint the exact overlap time, resolving the conflict instantly. ## Benefits - Stop manually cross-referencing availability. By calling list_resources and list_events together, you immediately see if a person is free during the exact dates needed for a new task. - You don't have to guess what data is missing. Use list_clients and list_projects to pull all necessary contextual information about who needs service and what that project entails. - Never miss a scheduling gap again. Calling list_unassigned helps you flag resources or time slots that are currently sitting empty, letting you fill them proactively. - Streamline reporting with the MCP. Instead of running separate reports for bookings (list_bookings) and events (list_events), your agent handles both calls in one go to give you a complete picture. - Keep context tight. You can list_tags alongside list_resources to understand not just *who* is available, but what skills or equipment they possess. ## How It Works The bottom line is, your AI client handles the complicated API calls and delivers clean scheduling facts straight to your chat window. 1. You tell your AI client to find scheduling information, which triggers a request through the MCP. 2. The MCP executes the necessary tool calls (like checking available resources or listing projects) and gathers raw data from Hub Planner. 3. Your agent receives structured results—a clear list of people, dates, and project statuses—and formats it for you. ## Frequently Asked Questions **How do I check resource availability using list_resources?** You use list_resources to get the full inventory of people and equipment. Then, you combine that with list_bookings and list_events so your agent can show you who is actually free during a specific date range. **What does list_unassigned do?** list_unassigned finds any bookings or time slots in the system that haven't been tied to a specific resource yet. This helps managers find gaps they can fill immediately. **Can I see which projects are active using list_projects?** Yes, calling list_projects gives you the full roster of all tracked projects. You can then use other tools to check if a specific resource is assigned to it. **How do I find out what clients we are working with?** Simply call list_clients. It retrieves every client record in the system, which gives you all the necessary context for scheduling work around them. **How do I check my current user permissions using get_me?** It returns the authenticated user's profile data. This lets you confirm which accounts or roles your AI agent is operating under before running any major actions. **What information does list_bookings provide about resource schedules?** This tool pulls specific scheduling records, showing who booked what and when. It gives granular details on occupied time slots, unlike a general listing of resources. **How can I find out about scheduled holidays or time off using list_events?** It lists all recorded events, primarily covering planned time-off and non-working days. This is separate from regular project bookings and helps identify unavailable capacity. **What are the purposes of tags listed by list_tags?** This tool retrieves a catalog of all metadata tags used across projects and resources. You can use these to classify data, making it easier for your agent to filter complex lists. **Where do I find my Hub Planner API Key?** Log in as Administrator, go to Settings > Integrations > API, and enable the API to generate your key. **Should I use 'Bearer' in the Authorization header?** No, Hub Planner requires the raw API key without any prefix in the Authorization header. **Can I see resource availability?** Yes, the list_resources and list_bookings tools help you understand resource allocation and availability.