# Runn MCP for AI Agents AI Agent Connect

> Runn MCP connects your AI to your resource planning and forecasting data. Get instant visibility into project pipelines, team capacity, and timesheet actuals directly via chat without switching tabs or manual data entry.

## Overview
- **Category:** erp-operations
- **Price:** Free
- **Endpoint:** https://edge.vinkius.com/vk_preview_R01M56JJJpYIg7GIrR6EtNtq96sDdR9Exy9H3SjK/ai-agent-connect
- **Tags:** resource-planning, capacity-forecasting, timesheet-tracking, project-pipelines, team-allocation, resource-management

## Description

This Connector lets your AI talk directly to Runn, pulling the heavy lifting of resource planning into a single conversation. Instead of hunting through dashboards to see who's overbooked or how a project is tracking, you can just ask your agent to do the digging. It pulls in everything from project metadata and client associations to specific team configurations and roles. You'll get a clear picture of your people's availability, current assignments, and actual billed hours against your forecasts. Because it's hosted on the Vinkius marketplace, you can get this connected to your favorite AI client in minutes. It's about moving from manual data hunting to getting direct answers on capacity bottlenecks and milestone progress. You can stop worrying about whether your team is stretched too thin or if a project is falling behind because the data is now accessible in plain English. Whether you're checking if a specific designer is available for a new sprint or looking for a high-level summary of a client's portfolio, this integration puts the data where you actually work. It handles the tedious parts of agency operations, like tracking who's on what phase of a project or identifying which roles are currently underutilized. You get a real-time pulse on your organization's output without the overhead of constant status meetings or manual spreadsheet updates.

## Tools

### get_project
Retrieves a deep dive into a single project. It's great for getting a quick summary of a specific scope.

### list_milestones
Shows the specific goals for a project. Use it to see what's coming up next on a timeline.

### list_phases
Breaks down a project into its different stages. Use this to see how far along a specific project is.

### list_projects
Pulls every project you're currently managing. This gives the AI a full view of your work pipeline.

### list_roles
Shows every position or role defined in your workspace. Use it to categorize your team's capabilities.

### list_teams
Lists all the different teams in your workspace. This helps you understand how your organization is structured.

### get_person
Pulls specific details for a team member. Use this to check someone's role or availability.

### list_actuals
Lists every hour logged on timesheets. This helps you see exactly how much time was actually spent on tasks.

### list_assignments
Shows every resource mapped to every project. Use this to spot where people are spread too thin.

### list_clients
Pulls a list of all your clients. It helps the AI understand your organization's portfolio.

### list_holidays
Lists non-working days and public holidays. This ensures your AI doesn't plan work on days off.

### list_people
Lists every person in your Runn account. It's the starting point for any resource-based query.

## Prompt Examples

**Prompt:** 
```
Which designers are currently overbooked on the Alpha project?
```

**Response:** 
```
Based on the current assignments in Runn, here is the status for the Alpha project:

| Team Member | Current Assignment | Estimated Hours |
| :--- | :--- | :--- |
| **Jane Doe** | Alpha Project | 45/40 (Overbooked) |
| **Mark Smith** | Alpha Project | 20/40 (Available) |

**Summary:** Jane Doe is currently exceeding her allocated hours for this project.
```

**Prompt:** 
```
Give me a summary of the milestones for the Beta launch.
```

**Response:** 
```
Project Beta has the following upcoming milestones:

* **Design Sign-off**: April 15th (Status: On Track)
* **MVP Release**: April 30th (Status: In Progress)

Both are currently tracking on schedule according to the latest Runn data.
```

**Prompt:** 
```
Compare our actual hours against the budget for the web redesign.
```

**Response:** 
```
Here is the comparison for the Web Redesign project:

* **Planned Hours:** 200
* **Actual Hours logged:** 245
* **Variance:** +45 hours

The project is currently 22.5% over the planned budget.
```

## Capabilities

### Compare actual hours to budgets
Use list_actuals to see how much time was actually spent on tasks versus your plan.

### Find overbooked team members
Use list_assignments to spot where people are spread too thin across various projects.

### Get a full list of clients
Use list_clients to help your AI understand your organization's entire portfolio.

### View upcoming project phases
Use list_phases to see how far along a specific project is in its lifecycle.

### See all managed projects
Use list_projects to give your agent a full view of your current work pipeline.

## Use Cases

### Checking team capacity
An agency owner uses list_teams to see which department is at max capacity before taking on a new client.

### Finding specific staff workload
A manager uses list_people to find a specific staff member's current workload and availability.

### Identifying budget leaks
A project lead identifies a budget leak by comparing actual hours against the original plan.

### Executive milestone summaries
An executive gets a high-level summary of all project milestones in one chat for a weekly update.

## Benefits

- Track milestones with list_milestones to stay on schedule.
- Account for non-working days with list_holidays for accurate forecasting.
- Understand organizational structures with list_roles.
- Get a clear view of team capacity without manual auditing.
- Identify resource gaps across multiple projects instantly.

## How It Works

The bottom line is you get a conversational interface for your entire resource planning platform.

1. Install the Runn integration into your workspace.
2. Generate a permanent API token in your Runn account settings.
3. Paste that token into the config and start asking questions.

## Frequently Asked Questions

**Can the Runn MCP show me my team's current capacity?**
Yes, it pulls your team's assignments and individual details so you can see exactly who is overbooked or available.

**How does the Runn MCP help with resource planning?**
It allows your AI to query your project pipelines, team roles, and assignments to help you make faster planning decisions.

**Can I use the Runn MCP to check project milestones?**
Yes, you can ask for a summary of milestones for any specific project to see what's coming up next.

**Does the Runn MCP include timesheet data?**
It pulls actual hours logged on timesheets, allowing you to compare real work against your original project forecasts.

**Is the Runn MCP good for agency operations?**
It's ideal for agency ops because it helps you track billed actuals versus forecasted hours across your entire client portfolio.

**Can the Runn MCP see my client list?**
Yes, it can pull a list of all your clients to help your agent understand your organization's full project scope.

**Can the AI add new resources, approve timesheets, or assign projects?**
No, this connector is constructed strictly logically explicitly purely as a read-only data extraction protocol naturally seamlessly securely flawlessly organically natively seamlessly explicitly efficiently. It pulls records, reporting scopes organically completely accurately carefully tightly mapped optimally.

**What data can the AI retrieve from Runn?**
The integration can list projects, people, roles, teams, milestones, and clients. It provides a comprehensive read-only view of your resource planning data.

**Can I see project budgets and utilization rates?**
Yes. By querying project details, the AI can surface budget allocations, scheduled hours, and utilization metrics for each project in your Runn workspace.