{"passport":{"unfragile":{"@version":"1.0","version":"2026-05","artifact":{"id":"npm_npm-shortcutmcp","slug":"npm-shortcutmcp","name":"@shortcut/mcp","type":"mcp","url":"https://www.npmjs.com/package/@shortcut/mcp","page_url":"https://unfragile.ai/npm-shortcutmcp","categories":["mcp-servers"],"tags":["shortcut","mcp","modelcontextprotocol"],"pricing":{"model":"open_source","free":true,"starting_price":null},"status":"active","verified":false},"capabilities":[{"id":"npm_npm-shortcutmcp__cap_0","uri":"capability://tool.use.integration.shortcut.workspace.resource.exposure.via.mcp.protocol","name":"shortcut workspace resource exposure via mcp protocol","description":"Exposes Shortcut project management workspace as MCP resources, allowing Claude and other MCP clients to read and reference Shortcut data (stories, epics, projects, teams) through standardized resource URIs. Implements MCP resource protocol with URI-based addressing (e.g., shortcut://story/123) and returns structured JSON representations of Shortcut entities, enabling LLM context injection without custom API integration code.","intents":["I want Claude to have access to my Shortcut workspace context when answering questions about project status","I need to reference specific stories or epics in Claude conversations without manually copying data","I want to build an agent that can read Shortcut data as part of its reasoning loop"],"best_for":["engineering teams using Shortcut for project management who want LLM-native access to workspace data","AI agent builders integrating project context into multi-step workflows","teams building Claude-powered development assistants"],"limitations":["Read-only access to Shortcut resources — no mutation/write capabilities exposed","Requires valid Shortcut API token with appropriate workspace permissions","Resource enumeration may be slow for workspaces with thousands of stories"],"requires":["Shortcut API token (generated from workspace settings)","Node.js 16+ runtime","MCP client implementation (Claude Desktop, or custom MCP host)","@shortcut/mcp npm package installed"],"input_types":["MCP resource URI strings (shortcut://story/*, shortcut://epic/*, etc.)","workspace identifiers"],"output_types":["JSON-structured Shortcut entities (stories with metadata, epics, projects, team members)","MCP resource list responses"],"categories":["tool-use-integration","memory-knowledge"],"confidence":0.5,"matches":0,"success_rate":0},{"id":"npm_npm-shortcutmcp__cap_1","uri":"capability://tool.use.integration.shortcut.tool.based.action.execution.via.mcp","name":"shortcut tool-based action execution via mcp","description":"Exposes Shortcut mutations and operations as MCP tools (function calls), allowing MCP clients to execute actions like creating stories, updating story state, adding comments, and managing workflow transitions. Implements MCP tool schema with parameter validation and returns operation results as structured responses, enabling programmatic Shortcut manipulation through LLM function-calling interfaces.","intents":["I want Claude to create a new story in Shortcut based on conversation context","I need to update story status or move stories between workflow states programmatically","I want Claude to add comments or attachments to existing Shortcut stories"],"best_for":["teams automating Shortcut workflow operations through Claude conversations","AI agents that need to mutate project state as part of task execution","development teams building Claude-powered project management assistants"],"limitations":["Tool availability depends on Shortcut API token permissions — some operations may be restricted by workspace role","No transactional batching — each tool call executes independently without rollback support","Rate limiting from Shortcut API applies to tool execution frequency"],"requires":["Shortcut API token with write permissions for intended operations","Node.js 16+ runtime","MCP client with tool-calling support (Claude Desktop, custom MCP host)","@shortcut/mcp npm package installed"],"input_types":["MCP tool parameters (story title, description, epic ID, project ID, state transitions, comment text)","structured JSON payloads for story/epic creation"],"output_types":["JSON responses containing created/updated Shortcut entity IDs and metadata","operation status and error details"],"categories":["tool-use-integration","automation-workflow"],"confidence":0.5,"matches":0,"success_rate":0},{"id":"npm_npm-shortcutmcp__cap_2","uri":"capability://tool.use.integration.mcp.server.lifecycle.and.authentication.management","name":"mcp server lifecycle and authentication management","description":"Handles MCP server initialization, Shortcut API authentication via token-based credentials, and connection lifecycle management. Implements MCP server protocol handshake, manages API token validation, and provides error handling for authentication failures. Abstracts credential management so MCP clients only need to provide the token once during server startup.","intents":["I want to start an MCP server that connects to my Shortcut workspace with minimal configuration","I need to ensure my Shortcut API token is securely passed to the MCP server","I want proper error messages if authentication fails"],"best_for":["developers setting up Shortcut MCP server for Claude Desktop or custom MCP hosts","teams deploying MCP servers in local or cloud environments","operators managing MCP server infrastructure"],"limitations":["Token must be provided via environment variable or startup configuration — no interactive auth flow","No token refresh mechanism — expired tokens require server restart","Single token per server instance — no multi-workspace support in single process"],"requires":["Shortcut API token (from workspace settings)","Node.js 16+ runtime","Environment variable or configuration file for token storage","Network connectivity to Shortcut API (api.shortcut.com)"],"input_types":["Shortcut API token string","MCP server configuration (port, host if applicable)"],"output_types":["MCP server ready state confirmation","authentication error messages"],"categories":["tool-use-integration","automation-workflow"],"confidence":0.5,"matches":0,"success_rate":0},{"id":"npm_npm-shortcutmcp__cap_3","uri":"capability://tool.use.integration.shortcut.entity.schema.mapping.to.mcp.types","name":"shortcut entity schema mapping to mcp types","description":"Maps Shortcut API entity schemas (stories, epics, projects, team members) to MCP resource and tool parameter schemas, ensuring type safety and discoverability. Implements schema translation layer that converts Shortcut API response structures into MCP-compliant resource descriptions and tool parameter definitions, enabling MCP clients to understand available operations and data structures without external documentation.","intents":["I want Claude to understand what fields are available on Shortcut stories without reading API docs","I need type validation for story creation parameters passed through MCP tools","I want MCP clients to auto-discover available Shortcut operations and their parameters"],"best_for":["MCP client developers building Shortcut integrations who need schema information","teams implementing schema-aware tool-calling for Shortcut operations","developers building IDE extensions or code generation tools that reference Shortcut schemas"],"limitations":["Schema mapping is static — changes to Shortcut API require package updates","Custom fields in Shortcut workspaces may not be fully represented in schema","Schema validation is client-side only — server-side validation depends on Shortcut API"],"requires":["@shortcut/mcp npm package with embedded schema definitions","MCP client with schema introspection support"],"input_types":["Shortcut API entity definitions","MCP schema specification"],"output_types":["JSON Schema definitions for MCP resources and tools","type information for IDE autocomplete"],"categories":["tool-use-integration","data-processing-analysis"],"confidence":0.5,"matches":0,"success_rate":0},{"id":"npm_npm-shortcutmcp__cap_4","uri":"capability://search.retrieval.shortcut.workspace.resource.enumeration.and.filtering","name":"shortcut workspace resource enumeration and filtering","description":"Implements resource discovery mechanism that enumerates Shortcut workspace entities (stories, epics, projects) and exposes them as MCP resources with optional filtering and pagination. Uses Shortcut API list endpoints to populate resource catalog, supporting filters by project, epic, state, and other metadata to enable efficient resource discovery without loading entire workspace into memory.","intents":["I want Claude to list all stories in a specific project without loading the entire workspace","I need to filter Shortcut stories by status or assignee for context injection","I want to enumerate epics in my workspace to reference them in conversations"],"best_for":["teams with large Shortcut workspaces who need efficient resource discovery","AI agents that need to search or filter project data before operating on it","Claude users wanting to reference specific stories without manual lookup"],"limitations":["Pagination may be required for workspaces with thousands of stories — full enumeration could be slow","Filtering is limited to Shortcut API query capabilities — complex custom filters not supported","Resource list is point-in-time snapshot — changes in Shortcut are not reflected until refresh"],"requires":["Shortcut API token with read permissions","Network connectivity to Shortcut API","@shortcut/mcp npm package"],"input_types":["filter parameters (project ID, epic ID, state, assignee)","pagination tokens"],"output_types":["MCP resource list with URIs and metadata","filtered entity summaries"],"categories":["search-retrieval","tool-use-integration"],"confidence":0.5,"matches":0,"success_rate":0}],"trust":{"score":35,"verified":false,"data_access_risk":"high","permissions":["Shortcut API token (generated from workspace settings)","Node.js 16+ runtime","MCP client implementation (Claude Desktop, or custom MCP host)","@shortcut/mcp npm package installed","Shortcut API token with write permissions for intended operations","MCP client with tool-calling support (Claude Desktop, custom MCP host)","Shortcut API token (from workspace settings)","Environment variable or configuration file for token storage","Network connectivity to Shortcut API (api.shortcut.com)","@shortcut/mcp npm package with embedded schema definitions"],"failure_modes":["Read-only access to Shortcut resources — no mutation/write capabilities exposed","Requires valid Shortcut API token with appropriate workspace permissions","Resource enumeration may be slow for workspaces with thousands of stories","Tool availability depends on Shortcut API token permissions — some operations may be restricted by workspace role","No transactional batching — each tool call executes independently without rollback support","Rate limiting from Shortcut API applies to tool execution frequency","Token must be provided via environment variable or startup configuration — no interactive auth flow","No token refresh mechanism — expired tokens require server restart","Single token per server instance — no multi-workspace support in single process","Schema mapping is static — changes to Shortcut API require package updates","builder identity is not verified yet","no observed match outcomes yet"],"rank_breakdown":{"adoption":0.4709599370526581,"quality":0.2,"ecosystem":0.38999999999999996,"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:24.482Z","last_scraped_at":"2026-05-03T14:23:33.846Z","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=npm-shortcutmcp","compare_url":"https://unfragile.ai/compare?artifact=npm-shortcutmcp"}},"signature":"5c+5x71Jytp4D/3gcOsJnE/czs9C7D8p8893b8TfsWZDdzBf83e4/cw5l4HNAO9t9dNOgrg4YxJSbEkXNOkICA==","signedAt":"2026-06-21T03:11:36.049Z","signedBy":"unfragile.ai","version":1},"_links":{"self":"https://unfragile.ai/api/v1/passport/npm-shortcutmcp","artifact":"https://unfragile.ai/npm-shortcutmcp","verify":"https://unfragile.ai/api/v1/verify?slug=npm-shortcutmcp","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"}}