Runn API Connector for AI agents.
12 live capabilities
Manage team capacity and project forecasting without leaving your chat.
Waiting for input…
Why people use Runn API
Runn for Real-Time Resource Planning
This Connector changes that by letting your AI do the digging for you. You can just ask about your team's bandwidth or a project's progress, and get a clear answer in seconds. It turns your resource data into a conversational capability.
What Vinkius changes
You get a conversational interface for your entire resource planning platform.
Use it from Claude, ChatGPT, Cursor or another AI client you already have.
One account · 5,900+ Connectors
- Real-world use case 01
Checking team capacity
An agency owner uses list_teams to see which department is at max capacity before taking on a new client.
- Real-world use case 02
Finding specific staff workload
A manager uses list_people to find a specific staff member's current workload and availability.
- Real-world use case 03
Identifying budget leaks
A project lead identifies a budget leak by comparing actual hours against the original plan.
Complete set · 12capabilities
The complete Runn API capability set.
These are the exact actions your AI can choose when you ask it to work with Runn API.
01—04
4 capabilities in this set.
Part of 12 available through Runn API.
- 01 Capability
Get project
Retrieves a deep dive into a single project. It's great for getting a quick summary of a specific scope.
- 02 Capability
List milestones
Shows the specific goals for a project. Use it to see what's coming up next on a timeline.
- 03 Capability
List phases
Breaks down a project into its different stages. Use this to see how far along a specific project is.
- 04 Capability
List projects
Pulls every project you're currently managing. This gives the AI a full view of your work pipeline.
05—08
4 capabilities in this set.
Part of 12 available through Runn API.
- 05 Capability
List roles
Shows every position or role defined in your workspace. Use it to categorize your team's capabilities.
- 06 Capability
List teams
Lists all the different teams in your workspace. This helps you understand how your organization is structured.
- 07 Capability
Get person
Pulls specific details for a team member. Use this to check someone's role or availability.
- 08 Capability
List actuals
Lists every hour logged on timesheets. This helps you see exactly how much time was actually spent on tasks.
09—12
4 capabilities in this set.
Part of 12 available through Runn API.
- 09 Capability
List assignments
Shows every resource mapped to every project. Use this to spot where people are spread too thin.
- 10 Capability
List clients
Pulls a list of all your clients. It helps the AI understand your organization's portfolio.
- 11 Capability
List holidays
Lists non-working days and public holidays. This ensures your AI doesn't plan work on days off.
- 12 Capability
List people
Lists every person in your Runn account. It's the starting point for any resource-based query.
Set up in minutes
One URL. Then ask Runn API to work.
Claude and ChatGPT only need the Connector URL. Copy it once, add it in settings, and use Runn API from the conversation.
Choose your client
Live previewAdvanced clients IDE · CLI
Claude · Web + desktop
Connector URL · ready to paste
Streamable HTTPhttps://edge.vinkius.com/vk_preview_R01M56JJJpYIg7GIrR6EtNtq96sDdR9Exy9H3SjK/mcp - Step 01
Open Connectors
In Claude Web or Claude Desktop, open Settings and choose Connectors.
- Step 02
Add the URL
Choose Add custom connector, name it Runn API, and paste the URL above.
- Step 03
Turn it on in chat
Select +, open Connectors, and enable Runn API for the conversation.
ChatGPT · Web + desktop
Connector URL · ready to paste
Streamable HTTPhttps://edge.vinkius.com/vk_preview_R01M56JJJpYIg7GIrR6EtNtq96sDdR9Exy9H3SjK/mcp - Step 01
Open MCP settings
On desktop, open Settings and MCP servers. On web, open your workspace app or connector settings.
- Step 02
Add the URL
Choose Add server with Streamable HTTP, or create a custom MCP app, then paste the Runn API URL.
- Step 03
Save and start
Save the connection and enable Runn API in your conversation. Desktop may ask you to restart once.
Cursor · IDE configuration
Advanced setup
{
"mcpServers": {
"runn": {
"url": "https://edge.vinkius.com/vk_preview_R01M56JJJpYIg7GIrR6EtNtq96sDdR9Exy9H3SjK/mcp"
}
}
}- Step 01
Open MCP Settings
Press Cmd+Shift+P (macOS) or Ctrl+Shift+P (Windows/Linux) → search "MCP Settings"
- Step 02
Add the server config
Paste the JSON configuration above into the mcp.json file that opens
- Step 03
Save the file
Cursor will automatically detect the new Connector
- Step 04
Start using Runn API
Open Agent mode in chat and ask: "Using Runn API, help me...". 12 tools available
VS Code Copilot · IDE configuration
Advanced setup
{
"mcpServers": {
"runn": {
"url": "https://edge.vinkius.com/vk_preview_R01M56JJJpYIg7GIrR6EtNtq96sDdR9Exy9H3SjK/mcp"
}
}
}- Step 01
Create MCP config
Create a .vscode/mcp.json file in your project root
- Step 02
Add the server config
Paste the JSON configuration above
- Step 03
Enable Agent mode
Open GitHub Copilot Chat and switch to Agent mode using the dropdown
- Step 04
Start using Runn API
Ask Copilot: "Using Runn API, help me...". 12 tools available
Windsurf · IDE configuration
Advanced setup
{
"mcpServers": {
"runn": {
"url": "https://edge.vinkius.com/vk_preview_R01M56JJJpYIg7GIrR6EtNtq96sDdR9Exy9H3SjK/mcp"
}
}
}- Step 01
Open MCP Settings
Go to Settings → MCP Configuration or press Cmd+Shift+P and search "MCP"
- Step 02
Add the server
Paste the JSON configuration above into mcp_config.json
- Step 03
Save and reload
Windsurf will detect the new server automatically
- Step 04
Start using Runn API
Open Cascade and ask: "Using Runn API, help me...". 12 tools available
Cline · IDE configuration
Advanced setup
{
"mcpServers": {
"runn": {
"url": "https://edge.vinkius.com/vk_preview_R01M56JJJpYIg7GIrR6EtNtq96sDdR9Exy9H3SjK/mcp"
}
}
}- Step 01
Open Cline MCP Settings
Click the Connectors icon in the Cline sidebar panel
- Step 02
Add remote server
Click "Add Connector" and paste the configuration above
- Step 03
Enable the server
Toggle the server switch to ON
- Step 04
Start using Runn API
Ask Cline: "Using Runn API, help me...". 12 tools available
Claude Code · Terminal command
Advanced setup
claude mcp add runn --transport http "https://edge.vinkius.com/vk_preview_R01M56JJJpYIg7GIrR6EtNtq96sDdR9Exy9H3SjK/mcp"- Step 01
Install Claude Code
Run npm install -g @anthropic-ai/claude-code if not already installed
- Step 02
Add the Connector
Run the command above in your terminal
- Step 03
Verify the connection
Run claude mcp to list connected servers, or type /mcp inside a session
- Step 04
Start using Runn API
Ask Claude: "Using Runn API, show me...". 12 tools are ready
Where the request belongs
Work Runn API can move forward.
It's for agency owners and project leads who are tired of manual capacity tracking and want to see the truth about their team's bandwidth without opening a spreadsheet.
Project Manager
Checks who is free to start a new project without manually auditing every person's calendar.
Agency Ops Lead
Pulls actual vs. forecasted hours to spot budget leaks during weekly reviews.
Executive
Gets a high-level summary of project milestones and team health in one prompt.
Build the capability set
Add more capabilities.
Each Connector adds new actions and data without changing how you work.
Browse ConnectorsProjectManager
Automate project planning and tracking via ProjectManager. manage projects, tasks, and timesheets directly from any AI agent.
Celoxis
Empower your AI agents to manage complex portfolios, track project milestones, and analyze resource timesheets on Celoxis.
Float
Manage team scheduling, project allocations, and time off via AI agents with Float.
Forecast
Manage AI-powered project resources via Forecast. track projects and tasks, handle team availability, and monitor milestones directly from any AI agent.
ONES
Enterprise R&D project management platform. manage tasks, projects, and workflows via AI.
Toggl Plan
Manage your team's visual timelines, track project phases, and balance workloads securely via your AI agent.
Bring your own AI
Change the model, client or framework. Keep Runn API connected.
-
Claude -
ChatGPT -
Gemini -
Cursor -
VS Code -
Windsurf -
ZCode -
Cline -
Zed -
Continue -
Kiro -
Roo Code -
Zencoder -
Goose -
Void -
Augment Code -
Amp -
Qodo -
Tabnine -
Pieces -
Sourcegraph Cody -
JetBrains -
Warp -
Amazon Q -
Antigravity -
BoltAI -
Raycast -
Jan -
LM Studio -
AnythingLLM -
Open WebUI -
Msty -
Cherry Studio -
LibreChat -
TypingMind -
Chorus -
5ire -
n8n -
LangChain -
LlamaIndex -
CrewAI -
Vercel AI SDK
Before you connect
Questions about Runn API.
The practical details behind the request, access and result.
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.
One connection away
Give your agent a direct line to Runn API.
Connect Runn API once. Keep it beside 5,900+ managed Connectors when the next task needs more.
Explore every Connector No credit card required · Free tier available