Skip to content

Conversation

@sash
Copy link

@sash sash commented Jul 10, 2025

Summary

This PR adds two new tools to the MCP server for more efficient story data retrieval:

  • get-story-summary: Returns only the title and description of a story
  • get-story-tasks: Returns all tasks (subtasks) for a story

Motivation

These tools provide more focused data retrieval options when you only need specific story information, avoiding the need to fetch the full story object when you just need the summary or tasks. Essential when trying to save model context.

Changes

  • Added get-story-summary tool that returns id, name, description, and app_url
  • Added get-story-tasks tool that returns all tasks with their details (id, description, complete, owner_ids, created_at, updated_at)
  • Both tools reuse the existing getStory() API call for efficiency
  • Updated tests to reflect the new tool count (from 15 to 17)

Testing

  • All existing tests pass
  • Updated StoryTools test to expect 17 tools instead of 15
  • Both new methods follow the existing error handling patterns

Example Usage

// Get just the story summary
await tools.getStorySummary(12345);

// Get all tasks for a story
await tools.getStoryTasks(12345);

Alexander (SASh) Alexiev and others added 4 commits July 10, 2025 17:18
- get-story-summary: Returns only title and description of a story
- get-story-tasks: Returns all subtasks for a story

Both tools reuse existing getStory() API call for efficiency

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <[email protected]>
- Update expected tool count from 15 to 17
- Add test expectations for new tools: get-story-summary and get-story-tasks

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <[email protected]>

server.tool(
"get-story-tasks",
"Get all tasks (subtasks) for a Shortcut story",
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
"Get all tasks (subtasks) for a Shortcut story",
"Get all tasks for a Shortcut story",

We must be cautious here because sub-tasks aren't the same as tasks.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Development

Successfully merging this pull request may close these issues.

2 participants