# Shortcut MCP for AI Agents AI Agent Connect > Shortcut MCP lets your AI agent act as a project manager. It can search stories, audit epics, track sprint progress, and map out team workflows directly from your IDE. No more tab-switching to check status; just ask your agent for the data you need. ## Overview - **Category:** developer-tools - **Price:** Free - **Endpoint:** https://edge.vinkius.com/vk_preview_RxfgpfVBAxP8QxPo5oXbiIfZbUAwTiIj8WR8FaUQ/ai-agent-connect - **Tags:** issue-tracking, kanban, scrum-management, software-development, workflow-automation, epic-tracking ## Description Imagine you're in the middle of a deep coding session and realize you're unsure about a specific task's requirements. Instead of pulling up a browser, switching tabs, and digging through a project board, you just ask your AI client for the details. This Connector gives your agent the keys to your entire project management workspace. It can pull up specific story descriptions, check which epic a bug belongs to, or list out all the active iterations for the quarter. It's like having a scrum master who lives inside your editor. You can ask it to find every task related to a specific database issue or get a high-level view of the roadmap. Because Vinkius makes it so easy to plug these tools into your existing workflow, you can actually move faster. You stop hunting for information and start acting on it. You get a clear picture of who's on the team, what the current workflow states are, and exactly where the blockers lie, all through a simple conversation. ## Tools ### list_iterations View all your sprints and iterations. Use this to track progress across different timeframes. ### get_story_details Pull the full description and sub-tasks for a specific story. Use this to get immediate clarity on requirements. ### list_projects Get a list of all projects in your Shortcut workspace. This helps you navigate large organizational structures. ### list_workflows See all the different workflows and status labels available. Use this to understand how tasks move through the pipeline. ### list_members Pull a list of everyone who has access to your workspace. This makes it easy to identify the right people for a task. ### search_stories Search for specific tasks or features in your Shortcut backlog. This helps you find relevant tickets without manual filtering. ### list_epics See all the high-level roadmaps and epics in your workspace. It's great for getting a bird's-eye view of project goals. ## Prompt Examples **Prompt:** ``` Find all stories about the login page. ``` **Response:** ``` I searched your backlog and found 4 stories related to the login page. **Results:** - *Login UI Refresh* (In Progress) - *OAuth Integration* (To Do) - *Password Reset Flow* (Done) - *Biometric Auth* (Backlog) Would you like me to pull the details for any of them? ``` **Prompt:** ``` What's the status of our current epics? ``` **Response:** ``` Here is the status of your current epics: | Epic Name | Status | Progress | | :--- | :--- | :--- | | **Q3 Payment Refactor** | Delayed | 45% | | **Client App Redesign** | On Track | 70% | | **Mobile API Sync** | Blocked | 10% | Most are on track, but **Q3 Payment Refactor** is currently stalled. Should I check the stories in that epic? ``` **Prompt:** ``` Who is on the team and what workflows do we have? ``` **Response:** ``` Your team currently has 12 members. **Active Workflows:** - **Engineering Workflow:** Unstarted, Ready for Dev, In Development, Completed. - **Design Workflow:** Draft, Review, Final. Would you like me to list the specific members for the Engineering team? ``` ## Capabilities ### Search your backlog Find specific stories or features in your Shortcut workspace using keywords. ### Pull story requirements Get the full description and sub-tasks for a single ticket instantly. ### Audit high-level roadmaps List all epics to see the big picture of your project goals. ### Track sprint progress View all iterations to see what's currently in progress. ### Map project structures Browse all projects and workflows to understand the workspace layout. ### Identify team members Get a list of all members in your workspace for easier coordination. ## Use Cases ### Clarifying ticket requirements A developer is confused about a ticket's scope. They ask the agent to pull the description and sub-tasks for a story using get_story_details. ### Stakeholder status updates A project manager needs a quick overview of the roadmap. They use list_epics to get a high-level summary of the current goals. ### Searching for specific bugs A QA engineer needs to find all database-related issues. They use search_stories with a keyword like 'database' to see every relevant issue. ### Onboarding new team members A new hire wants to know how tasks move from 'To Do' to 'Done'. They use list_workflows to see all available states. ## Benefits - Stop context switching by getting story details via get_story_details without leaving your editor. - Audit your roadmap faster by using list_epics to see high-level goals instantly. - Track team progress across sprints using list_iterations to spot delays before they happen. - Map out complex project structures easily with list_projects and list_workflows. - Identify team members quickly using list_members when you need to assign tasks. - Find specific bugs or features in seconds with search_stories instead of manual filtering. ## How It Works The bottom line is you get a project management assistant that knows your backlog as well as you do. 1. Add the Shortcut MCP to your agent framework and provide your API token. 2. Connect your AI client to the Vinkius catalog to activate the connection. 3. Ask your agent to perform project management tasks like finding stories or listing epics. ## Frequently Asked Questions **Can Shortcut MCP help me see my backlog?** Yes, it lets your agent search and read every story in your Shortcut workspace so you can find tasks quickly. **Does Shortcut MCP work with Cursor?** Yes, you can connect it to Cursor or any other MCP-compatible client like Claude or Windsurf. **Can I use Shortcut MCP to track my sprints?** It can pull your iterations so your agent knows exactly what's in the current sprint and what's coming up next. **Can my agent see my team members?** Yes, it can list all members in your workspace, making it much easier to coordinate with the right people. **Does Shortcut MCP let me edit tickets?** This specific MCP is designed for reading and auditing data. You cannot create or edit stories with this connection. **How do I connect Shortcut MCP to my AI?** You just need your Shortcut API token and a compatible client. Once connected, your agent can query your project data instantly. **Can the integration alter, comment in, or edit stories directly?** By structural design, this module is strictly bound as an observational lens. Operations such as `search_stories`, `list_epics`, and `get_story_details` parse and extract massive context. It omits explicitly write mechanisms preventing your autonomous agent from accidentally sabotaging valid roadmap components permanently. **Why use the token via MCP instead of normal webhook integrations?** Webhooks exclusively wait for explicit platform triggers passively. The Connector configuration hands your prompt active, unadulterated runtime authority to scan iterations, grab user arrays, and interrogate backlog metadata aggressively instantly dynamically. It permits pulling, rather than simply listening blindly. **Can the integration directly access workspaces not associated with the token creator?** No. The highly sensitive REST API access token acts inherently as a mapped functional clone of the exact user credentials operating at generation time. Searching workflows, epics, and members evaluates precisely against the internal permissions bounds of the token creator robustly limiting toxic footprint.