Shortcut

MCP server to interact with Shortcut API, Loom video analysis, and debugging plans.

typescript

0

GitHub Stars

typescript

Language

7 months ago

First Indexed

3 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "currentspace-shortcut_mcp": {
      "command": "./start_mcp.sh",
      "args": [],
      "env": {
        "SHORTCUT_TOKEN": "YOUR_TOKEN"
      }
    }
  }
}

You are equipped with a specialized MCP server that connects to Shortcut and Loom to manage stories, analyze Loom videos, correlate content with your codebase, and generate debugging plans. This server provides end-to-end tooling for reading, updating, and commenting on stories; downloading and inspecting attachments; extracting Loom videos; and producing actionable debugging guidance, all with strong type safety and robust error handling.

How to use

Start the MCP server using one of the provided startup scripts in your environment. The server exposes a set of tools you can invoke from an MCP client to read, search, and update stories, manage comments, list projects and workflows, download attachments, analyze Loom videos, correlate content with your codebase, and generate debugging plans.

How to install

Prerequisites: ensure you have Node.js installed and access to a shell. You will also need pnpm for package management.

Clone the project, install dependencies, configure your API token, and build the project with these steps.

Configuration and usage notes

Configure the Shortcut API token in your environment. Create a configuration file at the specified path and define SHORTCUT_TOKEN with your token value.

Start the MCP server with one of the available startup scripts. For development workflows or hot-reload scenarios, use the alternate startup scripts provided.

Development and tooling

The project includes scripts for development, building, type checking, linting, formatting, and testing. Use these commands to iterate on functionality and ensure type safety across your MCP server codebase.

Notes on error handling and performance

The server emits detailed error messages for missing tokens, API request failures, invalid IDs, and network issues. It also manages large responses with appropriate warnings when outputs exceed token thresholds.

Available tools

shortcut_get_story

Get detailed information about a specific story from Shortcut.

shortcut_search_stories

Search for stories using Shortcut's query syntax.

shortcut_get_project_stories

Retrieve all stories in a specific project.

shortcut_get_epic_stories

Retrieve all stories in a specific epic.

shortcut_update_story

Update story attributes such as description, labels, and workflow state.

shortcut_add_comment

Add a comment to a story.

shortcut_get_comments

Retrieve all comments for a story.

shortcut_list_workflows

List all workflows and their states.

shortcut_list_projects

List all projects in the workspace.

shortcut_list_epics

List all epics in the workspace.

shortcut_get_story_files

Get all file attachments for a story.

shortcut_download_file

Download file content from attachments.

shortcut_get_story_loom_videos

Extract Loom video links from a story.

shortcut_analyze_loom_video

Analyze Loom video metadata, transcript, and debugging insights.

shortcut_analyze_video_with_codebase

Correlate video content with codebase files.

shortcut_debug_video_issue

Deep debugging analysis with action tracking and error detection.

shortcut_analyze_video_with_anthropic

Visual analysis option using Claude Vision (currently disabled).