{"passport":{"unfragile":{"@version":"1.0","version":"2026-05","artifact":{"id":"npm-shortcut-mcp","slug":"shortcut-mcp","name":"@shortcut/mcp","type":"mcp","url":"https://github.com/useshortcut/mcp-server-shortcut#readme","page_url":"https://unfragile.ai/shortcut-mcp","categories":["mcp-servers"],"tags":["shortcut","mcp","modelcontextprotocol"],"pricing":{"model":"open_source","free":true,"starting_price":null},"status":"active","verified":false},"capabilities":[{"id":"npm-shortcut-mcp__cap_0","uri":"capability://tool.use.integration.shortcut.project.and.story.management.via.mcp.protocol","name":"shortcut project and story management via mcp protocol","description":"Exposes Shortcut's project management API through the Model Context Protocol, enabling Claude and other MCP-compatible AI clients to read and manipulate stories, epics, projects, and workflows. Implements MCP resource and tool schemas that map Shortcut's REST API endpoints into standardized tool definitions, allowing LLMs to query project state and trigger mutations without direct API knowledge.","intents":["I want Claude to understand my current Shortcut project structure and active stories","I need an AI agent to automatically create or update stories based on conversation context","I want to query story status, assignees, and estimates without leaving my AI chat interface","I need to sync story updates from Claude back into Shortcut without manual copy-paste"],"best_for":["engineering teams using Shortcut for project management who want AI-assisted planning","solo developers building LLM agents that need to interact with Shortcut workflows","teams migrating from manual Shortcut updates to AI-driven story creation and management"],"limitations":["Requires valid Shortcut API token with appropriate scopes — no built-in token refresh or rotation","MCP protocol overhead adds ~100-200ms per request compared to direct REST calls","No built-in caching of project state — each query hits Shortcut API, risking rate limits under high-frequency agent usage","Limited to Shortcut's API capabilities — cannot perform operations unsupported by Shortcut REST API","No transaction support — multi-step operations (e.g., create story + add labels + assign) require separate calls"],"requires":["Node.js 16+ (MCP server runtime)","Valid Shortcut API token with read/write scopes","MCP-compatible client (Claude Desktop, or custom MCP client implementation)","Network access to Shortcut API endpoints (api.app.shortcut.com)"],"input_types":["natural language queries (e.g., 'list all stories in the current sprint')","structured parameters (story IDs, project names, workflow states)","JSON payloads for story creation/update operations"],"output_types":["structured JSON (stories, projects, epics with metadata)","natural language summaries of project state","confirmation responses for mutations (create/update/delete)"],"categories":["tool-use-integration","automation-workflow"],"confidence":0.5,"matches":0,"success_rate":0},{"id":"npm-shortcut-mcp__cap_1","uri":"capability://search.retrieval.story.and.epic.querying.with.filtering.and.pagination","name":"story and epic querying with filtering and pagination","description":"Implements read-only MCP tools that query Shortcut's story and epic endpoints with support for filtering by project, workflow state, assignee, and label. Uses Shortcut's query parameters to enable efficient server-side filtering, reducing payload size and API calls. Supports pagination to handle large result sets without overwhelming the LLM context window.","intents":["I want to find all stories assigned to a specific team member in the current sprint","I need to list all epics in a project and their completion status","I want to search for stories with a specific label or tag","I need to retrieve stories in a particular workflow state (e.g., 'in progress', 'done')"],"best_for":["AI agents that need to understand project scope before making decisions","teams building LLM-powered dashboards or status reports from Shortcut data","developers creating context-aware agents that must filter stories by multiple dimensions"],"limitations":["Query complexity limited by Shortcut API's filter syntax — cannot perform complex boolean queries (e.g., 'stories assigned to Alice OR Bob AND in sprint X')","Pagination requires explicit offset/limit parameters — no cursor-based pagination, making large result sets inefficient","No full-text search across story descriptions — only metadata filtering (state, assignee, labels)","Results are point-in-time snapshots — no streaming or real-time updates if stories change during agent execution"],"requires":["Shortcut API token with read access to stories/epics","Knowledge of valid project IDs, workflow state names, and label names in the Shortcut workspace"],"input_types":["filter parameters (project_id, workflow_state, assignee_id, label_name)","pagination parameters (limit, offset)"],"output_types":["JSON array of story objects with metadata (id, name, state, assignee, estimate, labels)","JSON array of epic objects with child story counts and completion percentages"],"categories":["search-retrieval","data-processing-analysis"],"confidence":0.5,"matches":0,"success_rate":0},{"id":"npm-shortcut-mcp__cap_2","uri":"capability://tool.use.integration.story.and.epic.creation.with.automatic.field.validation","name":"story and epic creation with automatic field validation","description":"Implements MCP tools for creating stories and epics in Shortcut with schema-based validation of required fields (name, project, workflow state). Validates input parameters against Shortcut's API constraints before submission, providing early error feedback to the LLM. Supports optional fields like description, estimate, assignee, and labels, allowing flexible story creation workflows.","intents":["I want Claude to create a new story in Shortcut based on a conversation or requirement","I need to bulk-create stories from a list of requirements with consistent metadata","I want to create an epic and automatically link child stories to it","I need to create a story with a specific estimate and assignee based on context"],"best_for":["teams using AI to generate stories from requirements or user feedback","developers building agents that automate story creation workflows","non-technical product managers who want Claude to translate ideas into Shortcut stories"],"limitations":["No transaction support — if story creation succeeds but label assignment fails, the story is created without labels (no rollback)","Validation is schema-level only — cannot validate business logic (e.g., 'estimate must be <= sprint capacity')","No bulk creation endpoint — multiple stories require sequential API calls, increasing latency","Cannot create stories with custom fields beyond Shortcut's standard schema","Assignee and label validation requires pre-fetching valid IDs from Shortcut — no fuzzy matching on names"],"requires":["Shortcut API token with write access to stories","Valid project ID where the story will be created","Valid workflow state name (e.g., 'Unstarted', 'In Progress')","Optional: valid assignee ID, label IDs, epic ID for linking"],"input_types":["story name (required, string)","project ID (required, integer)","workflow state (required, string)","description (optional, string)","estimate (optional, integer)","assignee ID (optional, integer)","label IDs (optional, array of integers)","epic ID (optional, integer)"],"output_types":["created story object with ID, name, state, and metadata","error response with validation details if creation fails"],"categories":["tool-use-integration","automation-workflow"],"confidence":0.5,"matches":0,"success_rate":0},{"id":"npm-shortcut-mcp__cap_3","uri":"capability://tool.use.integration.story.and.epic.mutation.update.delete.with.change.tracking","name":"story and epic mutation (update, delete) with change tracking","description":"Implements MCP tools for updating story/epic fields (name, description, state, estimate, assignee, labels) and deleting stories. Supports partial updates — only specified fields are modified, leaving others unchanged. Tracks which fields were modified and returns the updated object, enabling agents to confirm changes and detect conflicts.","intents":["I want Claude to move a story to 'Done' when a task is completed","I need to update a story's estimate based on new information","I want to reassign a story to a different team member","I need to delete a story that's no longer relevant"],"best_for":["agents that manage story lifecycle (creation → progress → completion)","teams automating story state transitions based on external events","developers building AI-powered project management workflows"],"limitations":["No optimistic locking — concurrent updates from multiple agents can overwrite each other without conflict detection","Partial updates are applied sequentially — if one field update fails, previous updates are not rolled back","No audit trail of who/what changed a story — Shortcut's audit log is server-side only","Cannot update computed fields (e.g., story completion percentage, child story count)","Delete operations are permanent — no soft delete or undo capability"],"requires":["Shortcut API token with write access to stories","Valid story/epic ID to update or delete","For state transitions: valid workflow state name","For reassignment: valid assignee ID"],"input_types":["story ID (required, integer)","fields to update (optional, object with name, description, state, estimate, assignee_id, label_ids)","delete flag (optional, boolean)"],"output_types":["updated story object with new values","confirmation of deletion (if delete operation)","error response if update fails (e.g., invalid state transition)"],"categories":["tool-use-integration","automation-workflow"],"confidence":0.5,"matches":0,"success_rate":0},{"id":"npm-shortcut-mcp__cap_4","uri":"capability://search.retrieval.workflow.state.and.project.metadata.discovery","name":"workflow state and project metadata discovery","description":"Implements MCP tools that query Shortcut's workflow definitions and project metadata, returning valid workflow states, project names, and team structures. Enables agents to discover valid values for constrained fields (e.g., workflow states) without hardcoding them, improving robustness across different Shortcut workspaces.","intents":["I want Claude to know what workflow states are available in my Shortcut workspace","I need to list all projects so the agent can create stories in the right one","I want the agent to understand the team structure and valid assignees","I need to discover available labels and custom fields for story creation"],"best_for":["agents that must adapt to different Shortcut workspace configurations","teams with custom workflows that differ from Shortcut defaults","developers building multi-workspace agents that need to discover valid values dynamically"],"limitations":["Metadata discovery adds latency — agents must fetch workflow/project info before creating stories, increasing round-trip time","No caching of metadata — each agent session re-fetches the same data, wasting API calls","Metadata changes (new workflow state, new project) are not reflected until agent re-fetches","No support for custom fields beyond Shortcut's standard schema"],"requires":["Shortcut API token with read access to workspace metadata","Network access to Shortcut API"],"input_types":["optional: project ID to filter workflows for that project"],"output_types":["JSON array of workflow states with names and IDs","JSON array of projects with names and IDs","JSON array of team members with names and IDs","JSON array of available labels"],"categories":["search-retrieval","memory-knowledge"],"confidence":0.5,"matches":0,"success_rate":0},{"id":"npm-shortcut-mcp__cap_5","uri":"capability://tool.use.integration.mcp.protocol.transport.and.schema.mapping","name":"mcp protocol transport and schema mapping","description":"Implements the MCP server-side protocol handler that translates between MCP tool calls (from Claude or other MCP clients) and Shortcut API requests. Uses JSON schema definitions to describe tool parameters and return types, enabling clients to understand tool capabilities without documentation. Handles MCP request/response serialization, error handling, and protocol versioning.","intents":["I want Claude to understand what Shortcut operations are available and their parameters","I need reliable request/response handling between Claude and Shortcut API","I want to use Shortcut integration with any MCP-compatible client, not just Claude"],"best_for":["teams building multi-tool AI agents that need standardized protocol integration","developers creating custom MCP clients that need Shortcut support","organizations standardizing on MCP for LLM tool integration"],"limitations":["MCP protocol overhead adds ~100-200ms per request vs. direct REST calls","Schema validation is client-side — malformed requests from non-compliant clients may fail at Shortcut API level","No built-in request queuing or rate limiting — high-frequency agent usage can hit Shortcut API rate limits","Protocol version mismatch between client and server can cause compatibility issues","No built-in observability — debugging agent/API interactions requires external logging"],"requires":["Node.js 16+ runtime","MCP-compatible client (Claude Desktop, custom implementation)","Shortcut API token"],"input_types":["MCP tool call requests with JSON parameters"],"output_types":["MCP tool response with JSON result or error"],"categories":["tool-use-integration"],"confidence":0.5,"matches":0,"success_rate":0}],"trust":{"score":37,"verified":false,"data_access_risk":"high","permissions":["Node.js 16+ (MCP server runtime)","Valid Shortcut API token with read/write scopes","MCP-compatible client (Claude Desktop, or custom MCP client implementation)","Network access to Shortcut API endpoints (api.app.shortcut.com)","Shortcut API token with read access to stories/epics","Knowledge of valid project IDs, workflow state names, and label names in the Shortcut workspace","Shortcut API token with write access to stories","Valid project ID where the story will be created","Valid workflow state name (e.g., 'Unstarted', 'In Progress')","Optional: valid assignee ID, label IDs, epic ID for linking"],"failure_modes":["Requires valid Shortcut API token with appropriate scopes — no built-in token refresh or rotation","MCP protocol overhead adds ~100-200ms per request compared to direct REST calls","No built-in caching of project state — each query hits Shortcut API, risking rate limits under high-frequency agent usage","Limited to Shortcut's API capabilities — cannot perform operations unsupported by Shortcut REST API","No transaction support — multi-step operations (e.g., create story + add labels + assign) require separate calls","Query complexity limited by Shortcut API's filter syntax — cannot perform complex boolean queries (e.g., 'stories assigned to Alice OR Bob AND in sprint X')","Pagination requires explicit offset/limit parameters — no cursor-based pagination, making large result sets inefficient","No full-text search across story descriptions — only metadata filtering (state, assignee, labels)","Results are point-in-time snapshots — no streaming or real-time updates if stories change during agent execution","No transaction support — if story creation succeeds but label assignment fails, the story is created without labels (no rollback)","builder identity is not verified yet","no observed match outcomes yet"],"rank_breakdown":{"adoption":0.4709599370526581,"quality":0.22,"ecosystem":0.48999999999999994,"match_graph":0.25,"freshness":0.52,"weights":{"adoption":0.25,"quality":0.25,"ecosystem":0.15,"match_graph":0.23,"freshness":0.12}},"observed_outcomes":{"matches":0,"success_rate":0,"avg_confidence":0,"top_intents":[],"last_matched_at":null},"maintenance":{"status":"active","updated_at":"2026-05-24T12:16:23.902Z","last_scraped_at":"2026-05-03T14:04:47.472Z","last_commit":null},"community":{"stars":null,"forks":null,"weekly_downloads":11318,"model_downloads":null,"model_likes":null}},"distribution":{"claim_url":"https://unfragile.ai/submit?claim=shortcut-mcp","compare_url":"https://unfragile.ai/compare?artifact=shortcut-mcp"}},"signature":"c6eW8RK7neKt8ziiSDLSU8Ef+zhtM1ZOTxUsBa99yEVtBHfZNl6kke+xupcg6czLoWIsABXtesiqYPxPwKKLDA==","signedAt":"2026-06-22T18:40:50.392Z","signedBy":"unfragile.ai","version":1},"_links":{"self":"https://unfragile.ai/api/v1/passport/shortcut-mcp","artifact":"https://unfragile.ai/shortcut-mcp","verify":"https://unfragile.ai/api/v1/verify?slug=shortcut-mcp","publicKey":"https://unfragile.ai/api/v1/trust-passport-public-key","spec":"https://unfragile.ai/trust","schema":"https://unfragile.ai/schema.json","docs":"https://unfragile.ai/docs"}}