• ROADMAP
  • SPRINT
  • RISK
  • HUMAN

How to monitor project progress with your AI

Connect Shortcut to your AI client once. From there, your agent can scan your roadmap and active sprints to tell you exactly where things stand.

Ask AI about this page

Short answer

Can my AI track my roadmap health?

Yes. Your agent pulls data from Shortcut to compare high-level epics against active iterations. You'll see exactly where work is stalling or falling behind.

The outcomes.

What your AI uncovers.

The agent scans your Shortcut data to find these specific insights.

ROADMAP

Epic health checks

The AI looks at your epics to see if they are actually moving. You'll know which big initiatives are stalling.

SPRINT

Iteration status

By checking current iterations, your agent identifies if the team is overcommitted or falling behind schedule.

RISK

Bottleneck detection

The AI flags discrepancies between planned work and actual progress. This gives you a heads-up on upcoming delays.

HUMAN

Decision support

The AI provides the data, but you decide how to reallocate resources or shift deadlines based on its findings.

The workflow

What your AI does when the request arrives.

Your agent performs a sequence of lookups to build a complete picture of your project status.

  1. Fetch roadmap data

    The AI pulls a list of all your active epics to understand the long-term goals.

    list_epics

  2. Check current work

    It then looks at your active iterations to see the immediate tasks being tackled.

    list_iterations

  3. Compare progress

    The agent compares the epic goals against the iteration velocity to find gaps.

    list_epicslist_iterations

  4. Report findings

    Your AI summarizes the health of the roadmap and highlights specific risks.

    list_epics

Try it

Copy these to start.

Use these prompts to get immediate answers from your agent.

Starting points

These are just ways to kick off the conversation. Swap out the specific epic or iteration names to match your actual Shortcut setup.

Shortcut Connector

You're all set. Choose your MCP client and follow the setup instructions.

Connector linkhttps://edge.vinkius.com/vk_preview_RxfgpfVBAxP8QxPo5oXbiIfZbUAwTiIj8WR8FaUQ/mcp

Claude Desktop

Follow the steps below to connect in seconds.

  1. 1In Claude Desktop, open Settings → Connectors.
  2. 2Click “Add custom connector” and paste the connector link above as the remote MCP server URL.
  3. 3Click Add and start a new chat — Shortcut capabilities are ready to use.
Configuration · claude_desktop_config.jsonCopy
{
  "mcpServers": {
    "shortcut-mcp": {
      "url": "https://edge.vinkius.com/vk_preview_RxfgpfVBAxP8QxPo5oXbiIfZbUAwTiIj8WR8FaUQ/mcp"
    }
  }
}
Copy into chat04

  • Compare the progress of my 'Mobile App Redesign' epic against the current iteration.

  • Are there any epics that seem to be falling behind based on the current iteration work?

  • Summarize the health of all active epics in my Shortcut workspace.

  • Based on the current iteration, which epic is most at risk of missing its deadline?

  • Claude
  • ChatGPT
  • Cursor
  • VS Code
  • Windsurf
  • Claude Code
  • JetBrains
  • Cline

Start here

Connect Shortcut once, then ask.

Just link your account. Your credentials stay encrypted and secure. Once connected, you can use any of the prompts above in your preferred AI client.

Connect Shortcut to your AI

FAQ

How this task behaves

  • 01

    Can the AI change my roadmap or move epics?

    No. The AI can only read your data. You have to make all changes and updates manually in Shortcut.

  • 02

    Does the AI delete any of my iterations?

    No. This MCP is read-only for these tasks. It cannot delete, edit, or modify any of your Shortcut data.

  • 03

    How does it know which iteration is 'current'?

    The AI uses the list_iterations tool to see all active iterations and identifies the one currently in progress.

  • 04

    Can I use this with Claude?

    Yes, as long as you are using an MCP-compatible client like Claude Desktop.

  • 05

    Do I need to give it my Shortcut password?

    No. You connect via Vinkius, and your login details are handled securely through the connection process.

  • More questions about Shortcut? See everything the Shortcut Connector can do

Connect Shortcut to Claude, Cursor, ChatGPT & more