Skip to main content
Glama

Shortcut MCP Server

Official
by useshortcut

search-stories

Search for Shortcut stories by ID, name, type, state, owner, team, or other filters to efficiently locate specific tasks, bugs, or features within your project.

Instructions

Find Shortcut stories.

Input Schema

NameRequiredDescriptionDefault
branchNoFind only stories matching the specified branch
commentNoFind only stories matching the specified comment
commitNoFind only stories matching the specified commit
completedNoThe date in "YYYY-MM-DD" format, or one of the keywords: "yesterday", "today", "tomorrow", or a date range in the format "YYYY-MM-DD..YYYY-MM-DD". The date range can also be open ended by using "*" for one of the bounds. Examples: "2023-01-01", "today", "2023-01-01..*" (from Jan 1, 2023 to any future date), "*.2023-01-31" (any date up to Jan 31, 2023), "today..*" (from today onwards), "*.yesterday" (any date up to yesterday). The keywords cannot be used to calculate relative dates (e.g. the following are not valid: "today-1" or "tomorrow+1").
createdNoThe date in "YYYY-MM-DD" format, or one of the keywords: "yesterday", "today", "tomorrow", or a date range in the format "YYYY-MM-DD..YYYY-MM-DD". The date range can also be open ended by using "*" for one of the bounds. Examples: "2023-01-01", "today", "2023-01-01..*" (from Jan 1, 2023 to any future date), "*.2023-01-31" (any date up to Jan 31, 2023), "today..*" (from today onwards), "*.yesterday" (any date up to yesterday). The keywords cannot be used to calculate relative dates (e.g. the following are not valid: "today-1" or "tomorrow+1").
descriptionNoFind only stories matching the specified description
dueNoThe date in "YYYY-MM-DD" format, or one of the keywords: "yesterday", "today", "tomorrow", or a date range in the format "YYYY-MM-DD..YYYY-MM-DD". The date range can also be open ended by using "*" for one of the bounds. Examples: "2023-01-01", "today", "2023-01-01..*" (from Jan 1, 2023 to any future date), "*.2023-01-31" (any date up to Jan 31, 2023), "today..*" (from today onwards), "*.yesterday" (any date up to yesterday). The keywords cannot be used to calculate relative dates (e.g. the following are not valid: "today-1" or "tomorrow+1").
epicNoFind only stories matching the specified epic
estimateNoFind only stories matching the specified estimate
hasAttachmentNoFind only entities that have an attachment when true, or only entities that do not have an attachment when false. Example: hasOwner: true will find stories with an owner, hasOwner: false will find stories without an owner.
hasBranchNoFind only entities that have a branch when true, or only entities that do not have a branch when false. Example: hasOwner: true will find stories with an owner, hasOwner: false will find stories without an owner.
hasCommentNoFind only entities that have a comment when true, or only entities that do not have a comment when false. Example: hasOwner: true will find stories with an owner, hasOwner: false will find stories without an owner.
hasCommitNoFind only entities that have a commit when true, or only entities that do not have a commit when false. Example: hasOwner: true will find stories with an owner, hasOwner: false will find stories without an owner.
hasDeadlineNoFind only entities that have a deadline when true, or only entities that do not have a deadline when false. Example: hasOwner: true will find stories with an owner, hasOwner: false will find stories without an owner.
hasEpicNoFind only entities that have an epic when true, or only entities that do not have an epic when false. Example: hasOwner: true will find stories with an owner, hasOwner: false will find stories without an owner.
hasLabelNoFind only entities that have a label when true, or only entities that do not have a label when false. Example: hasOwner: true will find stories with an owner, hasOwner: false will find stories without an owner.
hasOwnerNoFind only entities that have an owner when true, or only entities that do not have an owner when false. Example: hasOwner: true will find stories with an owner, hasOwner: false will find stories without an owner.
hasPrNoFind only entities that have a pr when true, or only entities that do not have a pr when false. Example: hasOwner: true will find stories with an owner, hasOwner: false will find stories without an owner.
hasTaskNoFind only entities that have a task when true, or only entities that do not have a task when false. Example: hasOwner: true will find stories with an owner, hasOwner: false will find stories without an owner.
idNoFind only stories with the specified public ID
isArchivedNoFind only entities that are archived when true, or only entities that are not archived when false.
isBlockedNoFind only entities that are blocked when true, or only entities that are not blocked when false.
isBlockerNoFind only entities that are blocking when true, or only entities that are not blocking when false.
isDoneNoFind only entities that are completed when true, or only entities that are not completed when false.
isOverdueNoFind only entities that are overdue when true, or only entities that are not overdue when false.
isStartedNoFind only entities that are started when true, or only entities that are not started when false.
isUnestimatedNoFind only entities that are unestimated when true, or only entities that are not unestimated when false.
isUnstartedNoFind only entities that are unstarted when true, or only entities that are not unstarted when false.
labelNoFind only stories matching the specified label
nameNoFind only stories matching the specified name
nextPageTokenNoIf a next_page_token was returned from the search result, pass it in to get the next page of results. Should be combined with the original search parameters.
objectiveNoFind only stories matching the specified objective
ownerNoFind entities where the owner match the specified user. This must either be the user's mention name or the keyword "me" for the current user.
prNoFind only stories matching the specified pull request
priorityNoFind only stories matching the specified priority
productAreaNoFind only stories matching the specified product area
projectNoFind only stories matching the specified project
requesterNoFind entities where the requester match the specified user. This must either be the user's mention name or the keyword "me" for the current user.
severityNoFind only stories matching the specified severity
skillSetNoFind only stories matching the specified skill set
stateNoFind only stories matching the specified state
teamNoFind only stories matching the specified team. This can be a team mention name or team name.
technicalAreaNoFind only stories matching the specified technical area
typeNoFind only stories of the specified type
updatedNoThe date in "YYYY-MM-DD" format, or one of the keywords: "yesterday", "today", "tomorrow", or a date range in the format "YYYY-MM-DD..YYYY-MM-DD". The date range can also be open ended by using "*" for one of the bounds. Examples: "2023-01-01", "today", "2023-01-01..*" (from Jan 1, 2023 to any future date), "*.2023-01-31" (any date up to Jan 31, 2023), "today..*" (from today onwards), "*.yesterday" (any date up to yesterday). The keywords cannot be used to calculate relative dates (e.g. the following are not valid: "today-1" or "tomorrow+1").

Input Schema (JSON Schema)

{ "$schema": "http://json-schema.org/draft-07/schema#", "additionalProperties": false, "properties": { "branch": { "description": "Find only stories matching the specified branch", "type": "string" }, "comment": { "description": "Find only stories matching the specified comment", "type": "string" }, "commit": { "description": "Find only stories matching the specified commit", "type": "string" }, "completed": { "description": "The date in \"YYYY-MM-DD\" format, or one of the keywords: \"yesterday\", \"today\", \"tomorrow\", or a date range in the format \"YYYY-MM-DD..YYYY-MM-DD\". The date range can also be open ended by using \"*\" for one of the bounds. Examples: \"2023-01-01\", \"today\", \"2023-01-01..*\" (from Jan 1, 2023 to any future date), \"*.2023-01-31\" (any date up to Jan 31, 2023), \"today..*\" (from today onwards), \"*.yesterday\" (any date up to yesterday). The keywords cannot be used to calculate relative dates (e.g. the following are not valid: \"today-1\" or \"tomorrow+1\").", "pattern": "^(today|tomorrow|yesterday|\\d{4}-\\d{2}-\\d{2}|today\\.\\.\\*|\\*\\.\\.today|yesterday\\.\\.\\*|\\*\\.\\.yesterday|tomorrow\\.\\.\\*|\\*\\.\\.tomorrow|\\d{4}-\\d{2}-\\d{2}\\.\\.\\*|\\*\\.\\.\\d{4}-\\d{2}-\\d{2}|\\d{4}-\\d{2}-\\d{2}\\.\\.\\d{4}-\\d{2}-\\d{2})$", "type": "string" }, "created": { "description": "The date in \"YYYY-MM-DD\" format, or one of the keywords: \"yesterday\", \"today\", \"tomorrow\", or a date range in the format \"YYYY-MM-DD..YYYY-MM-DD\". The date range can also be open ended by using \"*\" for one of the bounds. Examples: \"2023-01-01\", \"today\", \"2023-01-01..*\" (from Jan 1, 2023 to any future date), \"*.2023-01-31\" (any date up to Jan 31, 2023), \"today..*\" (from today onwards), \"*.yesterday\" (any date up to yesterday). The keywords cannot be used to calculate relative dates (e.g. the following are not valid: \"today-1\" or \"tomorrow+1\").", "pattern": "^(today|tomorrow|yesterday|\\d{4}-\\d{2}-\\d{2}|today\\.\\.\\*|\\*\\.\\.today|yesterday\\.\\.\\*|\\*\\.\\.yesterday|tomorrow\\.\\.\\*|\\*\\.\\.tomorrow|\\d{4}-\\d{2}-\\d{2}\\.\\.\\*|\\*\\.\\.\\d{4}-\\d{2}-\\d{2}|\\d{4}-\\d{2}-\\d{2}\\.\\.\\d{4}-\\d{2}-\\d{2})$", "type": "string" }, "description": { "description": "Find only stories matching the specified description", "type": "string" }, "due": { "description": "The date in \"YYYY-MM-DD\" format, or one of the keywords: \"yesterday\", \"today\", \"tomorrow\", or a date range in the format \"YYYY-MM-DD..YYYY-MM-DD\". The date range can also be open ended by using \"*\" for one of the bounds. Examples: \"2023-01-01\", \"today\", \"2023-01-01..*\" (from Jan 1, 2023 to any future date), \"*.2023-01-31\" (any date up to Jan 31, 2023), \"today..*\" (from today onwards), \"*.yesterday\" (any date up to yesterday). The keywords cannot be used to calculate relative dates (e.g. the following are not valid: \"today-1\" or \"tomorrow+1\").", "pattern": "^(today|tomorrow|yesterday|\\d{4}-\\d{2}-\\d{2}|today\\.\\.\\*|\\*\\.\\.today|yesterday\\.\\.\\*|\\*\\.\\.yesterday|tomorrow\\.\\.\\*|\\*\\.\\.tomorrow|\\d{4}-\\d{2}-\\d{2}\\.\\.\\*|\\*\\.\\.\\d{4}-\\d{2}-\\d{2}|\\d{4}-\\d{2}-\\d{2}\\.\\.\\d{4}-\\d{2}-\\d{2})$", "type": "string" }, "epic": { "description": "Find only stories matching the specified epic", "type": "number" }, "estimate": { "description": "Find only stories matching the specified estimate", "type": "number" }, "hasAttachment": { "description": "Find only entities that have an attachment when true, or only entities that do not have an attachment when false. Example: hasOwner: true will find stories with an owner, hasOwner: false will find stories without an owner.", "type": "boolean" }, "hasBranch": { "description": "Find only entities that have a branch when true, or only entities that do not have a branch when false. Example: hasOwner: true will find stories with an owner, hasOwner: false will find stories without an owner.", "type": "boolean" }, "hasComment": { "description": "Find only entities that have a comment when true, or only entities that do not have a comment when false. Example: hasOwner: true will find stories with an owner, hasOwner: false will find stories without an owner.", "type": "boolean" }, "hasCommit": { "description": "Find only entities that have a commit when true, or only entities that do not have a commit when false. Example: hasOwner: true will find stories with an owner, hasOwner: false will find stories without an owner.", "type": "boolean" }, "hasDeadline": { "description": "Find only entities that have a deadline when true, or only entities that do not have a deadline when false. Example: hasOwner: true will find stories with an owner, hasOwner: false will find stories without an owner.", "type": "boolean" }, "hasEpic": { "description": "Find only entities that have an epic when true, or only entities that do not have an epic when false. Example: hasOwner: true will find stories with an owner, hasOwner: false will find stories without an owner.", "type": "boolean" }, "hasLabel": { "description": "Find only entities that have a label when true, or only entities that do not have a label when false. Example: hasOwner: true will find stories with an owner, hasOwner: false will find stories without an owner.", "type": "boolean" }, "hasOwner": { "description": "Find only entities that have an owner when true, or only entities that do not have an owner when false. Example: hasOwner: true will find stories with an owner, hasOwner: false will find stories without an owner.", "type": "boolean" }, "hasPr": { "description": "Find only entities that have a pr when true, or only entities that do not have a pr when false. Example: hasOwner: true will find stories with an owner, hasOwner: false will find stories without an owner.", "type": "boolean" }, "hasTask": { "description": "Find only entities that have a task when true, or only entities that do not have a task when false. Example: hasOwner: true will find stories with an owner, hasOwner: false will find stories without an owner.", "type": "boolean" }, "id": { "description": "Find only stories with the specified public ID", "type": "number" }, "isArchived": { "default": false, "description": "Find only entities that are archived when true, or only entities that are not archived when false.", "type": "boolean" }, "isBlocked": { "description": "Find only entities that are blocked when true, or only entities that are not blocked when false.", "type": "boolean" }, "isBlocker": { "description": "Find only entities that are blocking when true, or only entities that are not blocking when false.", "type": "boolean" }, "isDone": { "description": "Find only entities that are completed when true, or only entities that are not completed when false.", "type": "boolean" }, "isOverdue": { "description": "Find only entities that are overdue when true, or only entities that are not overdue when false.", "type": "boolean" }, "isStarted": { "description": "Find only entities that are started when true, or only entities that are not started when false.", "type": "boolean" }, "isUnestimated": { "description": "Find only entities that are unestimated when true, or only entities that are not unestimated when false.", "type": "boolean" }, "isUnstarted": { "description": "Find only entities that are unstarted when true, or only entities that are not unstarted when false.", "type": "boolean" }, "label": { "description": "Find only stories matching the specified label", "type": "string" }, "name": { "description": "Find only stories matching the specified name", "type": "string" }, "nextPageToken": { "description": "If a next_page_token was returned from the search result, pass it in to get the next page of results. Should be combined with the original search parameters.", "type": "string" }, "objective": { "description": "Find only stories matching the specified objective", "type": "number" }, "owner": { "description": "Find entities where the owner match the specified user. This must either be the user's mention name or the keyword \"me\" for the current user.", "type": "string" }, "pr": { "description": "Find only stories matching the specified pull request", "type": "number" }, "priority": { "description": "Find only stories matching the specified priority", "type": "string" }, "productArea": { "description": "Find only stories matching the specified product area", "type": "string" }, "project": { "description": "Find only stories matching the specified project", "type": "number" }, "requester": { "description": "Find entities where the requester match the specified user. This must either be the user's mention name or the keyword \"me\" for the current user.", "type": "string" }, "severity": { "description": "Find only stories matching the specified severity", "type": "string" }, "skillSet": { "description": "Find only stories matching the specified skill set", "type": "string" }, "state": { "description": "Find only stories matching the specified state", "type": "string" }, "team": { "description": "Find only stories matching the specified team. This can be a team mention name or team name.", "type": "string" }, "technicalArea": { "description": "Find only stories matching the specified technical area", "type": "string" }, "type": { "description": "Find only stories of the specified type", "enum": [ "feature", "bug", "chore" ], "type": "string" }, "updated": { "description": "The date in \"YYYY-MM-DD\" format, or one of the keywords: \"yesterday\", \"today\", \"tomorrow\", or a date range in the format \"YYYY-MM-DD..YYYY-MM-DD\". The date range can also be open ended by using \"*\" for one of the bounds. Examples: \"2023-01-01\", \"today\", \"2023-01-01..*\" (from Jan 1, 2023 to any future date), \"*.2023-01-31\" (any date up to Jan 31, 2023), \"today..*\" (from today onwards), \"*.yesterday\" (any date up to yesterday). The keywords cannot be used to calculate relative dates (e.g. the following are not valid: \"today-1\" or \"tomorrow+1\").", "pattern": "^(today|tomorrow|yesterday|\\d{4}-\\d{2}-\\d{2}|today\\.\\.\\*|\\*\\.\\.today|yesterday\\.\\.\\*|\\*\\.\\.yesterday|tomorrow\\.\\.\\*|\\*\\.\\.tomorrow|\\d{4}-\\d{2}-\\d{2}\\.\\.\\*|\\*\\.\\.\\d{4}-\\d{2}-\\d{2}|\\d{4}-\\d{2}-\\d{2}\\.\\.\\d{4}-\\d{2}-\\d{2})$", "type": "string" } }, "type": "object" }

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/useshortcut/mcp-server-shortcut'

If you have feedback or need assistance with the MCP directory API, please join our Discord server