Shortcut MCP Server for Mastra AI 7 tools — connect in under 2 minutes
Mastra AI is a TypeScript-native agent framework built for modern web stacks. Connect Shortcut through Vinkius and Mastra agents discover all tools automatically. type-safe, streaming-ready, and deployable anywhere Node.js runs.
ASK AI ABOUT THIS MCP SERVER
Vinkius supports streamable HTTP and SSE.
import { Agent } from "@mastra/core/agent";
import { createMCPClient } from "@mastra/mcp";
import { openai } from "@ai-sdk/openai";
async function main() {
// Your Vinkius token. get it at cloud.vinkius.com
const mcpClient = await createMCPClient({
servers: {
"shortcut": {
url: "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp",
},
},
});
const tools = await mcpClient.getTools();
const agent = new Agent({
name: "Shortcut Agent",
instructions:
"You help users interact with Shortcut " +
"using 7 tools.",
model: openai("gpt-4o"),
tools,
});
const result = await agent.generate(
"What can I do with Shortcut?"
);
console.log(result.text);
}
main();
* Every MCP server runs on Vinkius-managed infrastructure inside AWS - a purpose-built runtime with per-request V8 isolates, Ed25519 signed audit chains, and sub-40ms cold starts optimized for native MCP execution. See our infrastructure
About Shortcut MCP Server
Grant your AI agent (like Claude or Cursor) absolute administrative dominion over your Shortcut project management environment. The Shortcut MCP equips your LLM to act as a fully autonomous scrum master and project auditor. Forget clicking through endless boards—now you can interrogate task backlogs, audit iterations, and orchestrate developers exclusively via natural conversational prompts deeply integrated with the REST API.
Mastra's agent abstraction provides a clean separation between LLM logic and Shortcut tool infrastructure. Connect 7 tools through Vinkius and use Mastra's built-in workflow engine to chain tool calls with conditional logic, retries, and parallel execution. deployable to any Node.js host in one command.
What you can do
- Deep Story Infiltration — Rip through dense backlogs via
search_stories. Need the grit on a specific ticket? Drill down violently withget_story_detailsdirectly from your IDE to extract every description and sub-task effortlessly - Strategic Epic & Sprint Surveillance — Audit high-level roadmaps invoking
list_epicsand monitor ongoing sprints by extractinglist_iterationsto forecast roadmap failure or success without opening a single tab - Team & Workflow Cartography — Interrogate the hierarchy applying
list_projects, isolate specific developer IDs usinglist_members, and trace custom state mappings across the pipeline usinglist_workflows
The Shortcut MCP Server exposes 7 tools through the Vinkius. Connect it to Mastra AI in under two minutes — no API keys to rotate, no infrastructure to provision, no vendor lock-in. Your configuration, your data, your control.
How to Connect Shortcut to Mastra AI via MCP
Follow these steps to integrate the Shortcut MCP Server with Mastra AI.
Install dependencies
Run npm install @mastra/core @mastra/mcp @ai-sdk/openai
Replace the token
Replace [YOUR_TOKEN_HERE] with your Vinkius token
Run the agent
Save to agent.ts and run with npx tsx agent.ts
Explore tools
Mastra discovers 7 tools from Shortcut via MCP
Why Use Mastra AI with the Shortcut MCP Server
Mastra AI provides unique advantages when paired with Shortcut through the Model Context Protocol.
Mastra's agent abstraction provides a clean separation between LLM logic and tool infrastructure. add Shortcut without touching business code
Built-in workflow engine chains MCP tool calls with conditional logic, retries, and parallel execution for complex automation
TypeScript-native: full type inference for every Shortcut tool response with IDE autocomplete and compile-time checks
One-command deployment to any Node.js host. Vercel, Railway, Fly.io, or your own infrastructure
Shortcut + Mastra AI Use Cases
Practical scenarios where Mastra AI combined with the Shortcut MCP Server delivers measurable value.
Automated workflows: build multi-step agents that query Shortcut, process results, and trigger downstream actions in a typed pipeline
SaaS integrations: embed Shortcut as a first-class tool in your product's AI features with Mastra's clean agent API
Background jobs: schedule Mastra agents to query Shortcut on a cron and store results in your database automatically
Multi-agent systems: create specialist agents that collaborate using Shortcut tools alongside other MCP servers
Shortcut MCP Tools for Mastra AI (7)
These 7 tools become available when you connect Shortcut to Mastra AI via MCP:
get_story_details
Retrieves details for a specific story
list_epics
Lists all epics in Shortcut
list_iterations
Lists all iterations (sprints)
list_members
Lists all workspace members
list_projects
Lists all projects
list_workflows
g., "To Do", "Done") a story can be in. Lists all workflows and their states
search_stories
Useful for tracking specific tasks or features. Searches for stories in Shortcut
Example Prompts for Shortcut in Mastra AI
Ready-to-use prompts you can give your Mastra AI agent to start working with Shortcut immediately.
"Find all stories mentioning 'database timeout' using keyword search."
"List all ongoing epics and let me evaluate our current roadmap vectors."
"List workflows to show me all valid issue states in this organization."
Troubleshooting Shortcut MCP Server with Mastra AI
Common issues when connecting Shortcut to Mastra AI through the Vinkius, and how to resolve them.
createMCPClient not exported
npm install @mastra/mcpShortcut + Mastra AI FAQ
Common questions about integrating Shortcut MCP Server with Mastra AI.
How does Mastra AI connect to MCP servers?
MCPClient with the server URL and pass it to your agent. Mastra discovers all tools and makes them available with full TypeScript types.Can Mastra agents use tools from multiple servers?
Does Mastra support workflow orchestration?
Connect Shortcut with your favorite client
Step-by-step setup guides for every MCP-compatible client and framework:
Anthropic's native desktop app for Claude with built-in MCP support.
AI-first code editor with integrated LLM-powered coding assistance.
GitHub Copilot in VS Code with Agent mode and MCP support.
Purpose-built IDE for agentic AI coding workflows.
Autonomous AI coding agent that runs inside VS Code.
Anthropic's agentic CLI for terminal-first development.
Python SDK for building production-grade OpenAI agent workflows.
Google's framework for building production AI agents.
Type-safe agent development for Python with first-class MCP support.
TypeScript toolkit for building AI-powered web applications.
TypeScript-native agent framework for modern web stacks.
Python framework for orchestrating collaborative AI agent crews.
Leading Python framework for composable LLM applications.
Data-aware AI agent framework for structured and unstructured sources.
Microsoft's framework for multi-agent collaborative conversations.
Connect Shortcut to Mastra AI
Get your token, paste the configuration, and start using 7 tools in under 2 minutes. No API key management needed.