MCP Tools Reference

The SprintVibe MCP server provides 21 tools for interacting with your sprint data. Tools are called via JSON-RPC 2.0.

Read Tools

These tools require the read scope.

list_projects

List all projects accessible to the current user.

Parameters: None

Returns: Array of projects with name, description, tech stack, sprint count, and backlog story count.

get_project

Get project details including description, tech stack, context, sprint/story counts, and nested sprints.

Parameter	Type	Required	Description
`project_id`	integer	Yes	The project ID

Returns: Project object with context, tech stack, and sprints array.

get_sprint

Get sprint details including epics and stories.

Parameter	Type	Required	Description
`sprint_id`	integer	Yes	The sprint ID

Returns: Sprint object with epics and stories arrays.

list_sprints

List all sprints for a project, optionally filtered by status.

Parameter	Type	Required	Description
`project_id`	integer	Yes	The project ID
`status`	string	No	`planning`, `active`, `completed`

Returns: Array of sprint objects with name, goal, dates, and counts.

list_stories

List stories in a sprint with optional filters.

Parameter	Type	Required	Description
`sprint_id`	integer	Yes	The sprint ID
`status`	string	No	`todo`, `in_progress`, `review`, `done`
`epic_id`	integer	No	Filter by epic
`user_id`	integer	No	Filter by assignee

Returns: Array of story objects with epic and assignee details.

get_story

Get full story details with tasks, project context, sprint context, attachments, and linked pull requests.

Parameter	Type	Required	Description
`story_id`	integer	Yes	The story ID

Returns: Complete story object including tasks, project tech stack, sprint goal, file attachments, and pull_requests array.

get_backlog

Get backlog stories for a project (stories not assigned to any sprint).

Parameter	Type	Required	Description
`project_id`	integer	Yes	The project ID
`status`	string	No	`todo`, `in_progress`, `review`, `done`
`priority`	string	No	`low`, `medium`, `high`, `critical`

Returns: Array of story objects with tasks included.

get_code_context

Get the AI-generated codebase profile for a project's connected GitHub repository.

Parameter	Type	Required	Description
`project_id`	integer	Yes	The project ID

Returns: Object with project name and code_context text (the AI-generated codebase profile).

list_comments

List comments on a story, ordered by most recent first.

Parameter	Type	Required	Description
`story_id`	integer	Yes	The story ID

Returns: Array of comment objects with content, user name, and timestamp.

search_stories

Search stories by title across all accessible projects.

Parameter	Type	Required	Description
`query`	string	Yes	Search query
`project_id`	integer	No	Limit search to a specific project

Returns: Array of matching story objects (max 25 results).

summarize_pr

Generate an AI-powered summary of a pull request, comparing the diff against the story's acceptance criteria and tasks. Requires Pro or Teams plan.

Parameter	Type	Required	Description
`story_id`	integer	Yes	The story ID
`pr_id`	integer	No	The PR ID (defaults to latest open PR)

Returns: Object with pr_id, pr_number, summary (markdown), and generated_at. Requires write scope.

get_repo_activity

Get development activity for a project's GitHub repository. Requires Pro or Teams plan.

Parameter	Type	Required	Description
`project_id`	integer	Yes	The project ID
`days`	integer	No	Number of days to look back (default: 30, max: 90)

Returns: Object with stats (commits, PRs opened/merged, reviews), commits_per_day, top_contributors, and recent_activity feed.

list_epics

List all epics in a sprint.

Parameter	Type	Required	Description
`sprint_id`	integer	Yes	The sprint ID

Returns: Array of epic objects with name, description, color, and position.

get_my_work

Get all stories assigned to the current user in active sprints, grouped by status.

Parameters: None

Returns: Object with todo, in_progress, review, and done arrays.

Write Tools

These tools require the write scope.

update_story

Update a story's fields.

Parameter	Type	Required	Description
`story_id`	integer	Yes	The story ID
`title`	string	No	New title
`description`	string	No	New description
`acceptance_criteria`	string	No	New acceptance criteria
`status`	string	No	`todo`, `in_progress`, `review`, `done`
`priority`	string	No	`low`, `medium`, `high`, `critical`
`story_points`	integer	No	New estimate
`epic_id`	integer	No	Epic to assign to
`user_id`	integer	No	Assignee (null to unassign)

create_story

Create a new story in a sprint.

Parameter	Type	Required	Description
`sprint_id`	integer	Yes	Target sprint
`title`	string	Yes	Story title
`description`	string	No	Description
`acceptance_criteria`	string	No	Acceptance criteria
`epic_id`	integer	No	Epic to assign to
`priority`	string	No	`low`, `medium`, `high`, `critical`
`story_points`	integer	No	Effort estimate

add_comment

Add a comment to a story.

Parameter	Type	Required	Description
`story_id`	integer	Yes	The story ID
`content`	string	Yes	Comment text

create_task

Create a task (checklist item) on a story.

Parameter	Type	Required	Description
`story_id`	integer	Yes	The story ID
`title`	string	Yes	Task title

update_task

Update a task's title or completion status.

Parameter	Type	Required	Description
`task_id`	integer	Yes	The task ID
`title`	string	No	New title
`completed`	boolean	No	Completion status

update_sprint

Update a sprint's status or goal.

Parameter	Type	Required	Description
`sprint_id`	integer	Yes	The sprint ID
`status`	string	No	`planning`, `active`, `completed`
`goal`	string	No	Updated sprint goal

create_epic

Create a new epic in a sprint.

Parameter	Type	Required	Description
`sprint_id`	integer	Yes	Target sprint
`name`	string	Yes	Epic name
`description`	string	No	Description
`color`	string	No	Hex color (e.g., `#FF5733`)

update_epic

Update an epic's name, description, or color.

Parameter	Type	Required	Description
`epic_id`	integer	Yes	The epic ID
`name`	string	No	New name
`description`	string	No	New description
`color`	string	No	New hex color