# Hub Planner MCP for AI Agents AI Agent Connect

> Hub Planner. Manage your team's capacity, equipment, and project timelines without switching tabs. Use this Connector to let your AI agent handle bookings, track project progress, and organize resources. It connects your AI client directly to the Hub Planner API for real-time operational oversight.

## Overview
- **Category:** productivity
- **Price:** Free
- **Endpoint:** https://edge.vinkius.com/vk_preview_jvXXAiEf8dOLOpF0goqBhfkA3kLD1Gp16pFexCjq/ai-agent-connect
- **Tags:** resource-allocation, capacity-planning, project-scheduling, time-tracking, team-management

## Description

Hub Planner connects your AI agents to your resource management data. Imagine you're juggling three different projects, each with its own set of people, specialized equipment, and tight deadlines. Right now, you probably have a dozen tabs open just to see who's available, which machine is booked for next Tuesday, and which client actually paid their latest invoice. This Connector changes that by giving your AI agent a direct line into your account. Instead of manually cross-referencing calendars, you can just ask your agent to find an open slot for a specific piece of gear or check if a team member is on vacation. It handles the heavy lifting of data retrieval so you can focus on making the actual decisions. When you find this in the Vinkius catalog, you're getting a way to turn your static planning data into an active workspace. Your agent can pull lists of clients, organize projects by tag, and identify unassigned bookings in seconds. It's about moving from "Where is that info?" to "Here's what we need to do next." It removes the friction of navigating menus and clicking through filters. You can check your team's capacity or find a specific project's status without ever leaving your conversation. This makes it much easier to keep everyone on the same page and ensure that no resource is double-booked or forgotten.

## Tools

### get_me
This tool retrieves the details of the currently authenticated user. It's useful for confirming which account your agent is currently accessing.

### list_bookings
This pulls a list of all current resource bookings. Use it to see which equipment or people are already committed for specific times.

### list_categories
This fetches the different categories used for bookings. It helps your agent organize and filter your data into logical groups.

### list_clients
This gets a full list of all clients in your account. It's a quick way for your agent to stay informed about your customer base.

### list_events
This shows upcoming events and scheduled time-off. Use it to plan around staff absences and company holidays.

### list_projects
This lists all active and archived projects. It's perfect for getting a high-level overview of your current workload.

### list_resources
This identifies all available resources, including people and equipment. It helps you see exactly what's on hand at a glance.

### list_tags
This shows the tags used to organize projects and resources. Use it to keep your data structured and easily searchable by your agent.

### list_teams
This pulls a list of all teams within the organization. It's useful for identifying which department owns specific resources.

### list_unassigned
This finds bookings that haven't been assigned to a resource yet. Use it to spot and fill gaps in your scheduling.

## Prompt Examples

**Prompt:** 
```
Who's on vacation next week?
```

**Response:** 
```
Here are the team members scheduled for time-off next week:

| Team Member | Dates |
| :--- | :--- |
| Sarah Jenkins | Oct 12 - Oct 15 |
| Mike Ross | Oct 14 - Oct 18 |

I've checked the events and confirmed these are the only upcoming absences.
```

**Prompt:** 
```
List all active projects with the 'High Priority' tag.
```

**Response:** 
```
I found 3 projects currently tagged as **High Priority**:

* **Project Alpha** (Status: In Progress)
* **Project Gamma** (Status: Planning)
* **Project Zeta** (Status: Delayed)

Would you like me to pull more details on any of these?
```

**Prompt:** 
```
Are there any bookings without a resource assigned?
```

**Response:** 
```
I've identified 2 bookings that still need a resource assignment:

1. **Booking #4492** (Excavator Rental) - Scheduled for Oct 20
2. **Booking #4501** (Site Cleanup) - Scheduled for Oct 22

Do you want me to assign a team member to these?
```

## Capabilities

### Check team availability
Your agent identifies which team members are free or booked for specific dates.

### View project progress
Get a list of all active projects and their current status instantly.

### Fetch client details
Pull contact information and categories for your entire client base.

### Find unassigned bookings
Identify resources that are booked but haven't been assigned to a specific person.

### List team categories
See how your teams and resources are organized into different groups.

### Track time-off events
View upcoming vacations and scheduled time-off for the whole team.

## Use Cases

### Resource Conflict Resolution
You need to know if a forklift is free for a job. Your agent checks list_bookings and list_resources to confirm availability in seconds.

### Client Onboarding
A new client joins the roster. Your agent uses list_clients and list_categories to set up their profile and assign them to the right team.

### Project Audit
You need a status report for a stakeholder. Your agent pulls list_projects and list_tags to summarize current work and priorities.

### Capacity Planning
You're planning next month's schedule. Your agent checks list_events and list_unassigned to find gaps in your team's capacity.

## Benefits

- Stop manual cross-referencing. Use list_resources and list_bookings to see exactly what's available without opening the web app.
- Get instant project overviews. Pull lists of list_projects and list_tags to see how your work is grouped and progressing.
- Identify gaps faster. Use list_unassigned to spot bookings that need attention before they become problems.
- Centralize client info. Access list_clients and list_categories to keep your agent informed about your customer base.
- Plan around absences. Use list_events to see who's out of the office before you schedule new tasks.

## How It Works

The bottom line is you get a way to query your entire operational backend using natural language.

1. Connect your Hub Planner API keys to the Vinkius platform.
2. Authorize your AI client to access your specific resources and projects.
3. Ask your agent to perform actions like listing projects or finding open bookings.

## Frequently Asked Questions

**Can Hub Planner MCP manage my team's schedules?**
Yes, it lets your AI agent see who's available and who's on time-off by pulling data from your active bookings and events.

**How does Hub Planner MCP help with equipment?**
It lists all your resources, so you can ask your agent if specific tools or machinery are currently booked.

**Can I use Hub Planner MCP to see my client list?**
Absolutely. Your agent can pull a full list of your clients to help you stay organized during meetings.

**Does Hub Planner MCP track project tags?**
Yes, it lets you see how projects are categorized and tagged so you can filter your work more easily.

**Can I find unassigned bookings with Hub Planner MCP?**
Yes, the agent can specifically look for bookings that don't have a resource attached yet.

**Is Hub Planner MCP good for capacity planning?**
It's perfect for that. You can ask your agent to check for gaps in your resource schedule and upcoming project deadlines.

**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.