# Runn MCP > Runn gives your AI client total visibility into resource planning, capacity forecasting, and project pipelines. Instead of clicking through dashboards to find out who's assigned where or how many hours were billed, you simply ask your agent in natural chat language. Get real-time data on people, projects, assignments, and actual timesheets instantly. ## Overview - **Category:** erp-operations - **Price:** Free - **Tags:** resource-planning, capacity-forecasting, timesheet-tracking, project-pipelines, team-allocation, resource-management ## Description Think about managing a large client engagement. You need to know if the design team has bandwidth next month, who's working on Project X right now, and whether the hours logged actually match what was planned. This MCP connects your agent directly to Runn’s core data set. It lets you pull essential project metadata, current resource allocations, people details, and timesheet logs straight into your conversation. You can ask for a list of all projects or check specific milestones for an initiative. Need to compare budgeted work against actual billed hours? Your agent pulls the `list_actuals` report instantly. Because this integration is hosted on Vinkius, you connect once from any compatible AI client and gain access to this deep project data without needing dedicated software logins. This means your conversations become operational dashboards. Instead of juggling spreadsheets or navigating complex menus, you just ask: 'Who needs to sign off on the Beta project?' The answer comes back with names, roles, and dates. It's about getting immediate, actionable clarity on resource capacity. ## Tools ### get_person Retrieves specific details for any person in the system. ### get_project Pulls detailed information about a single, specified project. ### list_actuals Generates a list of logged hours from timesheet data for billing review. ### list_assignments Lists all people and resources currently assigned across every project. ### list_clients Retrieves a list of all clients associated with the organization. ### list_holidays Provides a record of public holidays and non-working days for scheduling accuracy. ### list_milestones Lists all major completion points planned for a specific project. ### list_people Gets a complete roster of every person and resource in the Runn system. ### list_phases Shows all defined project phases for a specific operational scope. ### list_projects Retrieves a list of every active and completed project managed in the system. ### list_roles Lists all official job roles or positions defined within the organization's structure. ### list_teams Retrieves a list of every team set up within your workspace. ## Prompt Examples **Prompt:** ``` List all active projects mapped. ``` **Response:** ``` I securely reliably naturally organically verified the Runn platform logs appropriately seamlessly dynamically pulling precisely 5 active tracked project namespaces successfully accurately flawlessly organically explicitly gracefully dynamically successfully smartly meticulously correctly comprehensively smartly efficiently naturally securely mapped seamlessly faithfully smoothly efficiently gracefully successfully smoothly. ``` **Prompt:** ``` Which team is assigned to the Alpha project next week? ``` **Response:** ``` The 'Frontend Engineering' and 'Design' teams are assigned to Project Alpha next week. Lead designer Jane Doe is allocated for 20 hours, and developer Mark Smith for 35 hours. ``` **Prompt:** ``` What are the upcoming milestones for the Beta project? ``` **Response:** ``` Project Beta has 2 upcoming milestones: 'Design Sign-off' on April 15th and 'MVP Release' on April 30th. Both are currently tracking on schedule. ``` ## Capabilities ### Identify all projects and clients Get comprehensive lists of every project or client managed in the organization. ### Track team assignments and roles Find out exactly who is assigned to which project phase, listing people, teams, and defined job roles. ### Review resource capacity and availability Check if specific people are free or overloaded by querying their details across multiple projects. ### Analyze project timelines and goals Retrieve key project milestones, track assigned team members, or see the full history of a single operational scope. ### Compare planned work versus billed hours Pull detailed timesheet data to compare recorded actuals against anticipated labor costs. ## Use Cases ### Checking for resource bottlenecks before kickoff The PM needs to know if the Beta project can start next week. They ask their agent, 'What capacity do we have?' The agent uses `list_assignments` and compares it against the available people from `list_people`, instantly flagging that three key developers are already allocated elsewhere. ### Billing discrepancy investigation The Agency Operations Lead notices a client account looks under-billed. They ask their agent to run a comparison, and the tool uses `list_actuals` against project metadata to show exactly which hours were logged but not invoiced. ### Executive status report generation The Executive needs a summary of all major initiatives. They prompt their agent to list all active projects using `list_projects`, and the tool gathers key details, including the next critical milestone for each one. ### Understanding team structure for new hires A new employee needs context on departmental roles. They ask their agent to list all defined roles using `list_roles` and then check which teams are currently utilizing those roles, providing an immediate organizational map. ## Benefits - Stop guessing about capacity. Instead of clicking through multiple dashboards to see who's available, ask your agent directly: 'Who is assigned to the internal design project?' - Manage budgets accurately by calling `list_actuals`. You get an instant comparison between planned work and the billed hours logged in timesheets. - Get a clear view of team structure using `list_people` and `list_roles`. You can immediately know who has which title without navigating HR systems. - Track project progress effortlessly. Use `list_milestones` to ask for all upcoming deadlines or use `get_project` to get a deep dive into one specific scope. - Avoid scheduling conflicts by checking team availability and roles simultaneously, combining data from `list_assignments` with your natural query. ## How It Works The bottom line is that providing an API token lets your AI agent read live project data from Runn and use it in conversation. 1. Install the core Runn integration into your secure workspace. 2. Log into your primary Runn account online, navigate to Settings, and generate a permanent API access string. 3. Securely provide this specific Runn API Token in the integration's configuration section. ## Frequently Asked Questions **How do I find out who is assigned to Project Alpha using Runn MCP?** You can use the `list_assignments` tool. This pulls all current resources and people linked to that project, giving you a complete picture of the team structure. **Can Runn MCP help me with billing questions?** Yes, it uses `list_actuals`. You can ask your agent to pull detailed timesheet data to compare what was worked against what was budgeted or billed for a client. **What is the easiest way to see all open projects?** Just use `list_projects`. This tool gives you an immediate overview of every active project name and ID in the system, helping you narrow down your focus areas. **How do I check who is available next month with Runn MCP?** Check capacity using `list_people` and then cross-reference that list against current assignments. You can ask the agent to analyze both data sets for you. **Do I need to worry about holidays when scheduling? Is Runn MCP accurate?** No. The `list_holidays` tool provides an authoritative list of public and company non-working days, ensuring any schedule your agent builds accounts for proper time off.