shortcut workspace resource exposure via mcp protocol
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.
Unique: Implements MCP resource protocol specifically for Shortcut, providing standardized URI-based access to project management entities rather than requiring custom API wrapper code. Uses MCP's resource discovery mechanism to expose Shortcut workspace hierarchy.
vs alternatives: Enables native Shortcut context in Claude conversations via MCP standard, eliminating need for custom Shortcut API client code or manual data copying compared to direct API integration approaches
shortcut tool-based action execution via mcp
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.
Unique: Wraps Shortcut API mutations as MCP tools with schema-based parameter validation, allowing LLMs to execute project management operations through standardized function-calling interface rather than requiring custom API client instantiation.
vs alternatives: Provides LLM-native Shortcut mutation capability via MCP tools, enabling Claude to modify project state directly compared to read-only resource access or requiring separate API integration layers
mcp server lifecycle and authentication management
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.
Unique: Implements MCP server protocol with Shortcut-specific authentication, handling token validation and API connection setup as part of MCP initialization rather than delegating to client code.
vs alternatives: Simplifies Shortcut integration by centralizing authentication at MCP server startup, eliminating per-request credential handling compared to client-side API wrapper approaches
shortcut entity schema mapping to mcp types
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.
Unique: Translates Shortcut entity schemas into MCP-compliant type definitions, providing schema-aware tool-calling and resource discovery without requiring separate schema documentation or manual type definitions.
vs alternatives: Enables type-safe Shortcut operations through MCP schema introspection, providing better IDE support and parameter validation compared to untyped API wrapper approaches
shortcut workspace resource enumeration and filtering
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.
Unique: Implements MCP resource enumeration with Shortcut-specific filtering and pagination, allowing efficient discovery of workspace entities without materializing entire workspace state.
vs alternatives: Provides filtered resource discovery through MCP standard, enabling selective context injection compared to loading entire workspace or requiring manual resource URI specification