---
title: "User stories and planning kits | OwlMeans"
description: "Use a focused story for behavior you can try and a planning kit when it fits the project."
url: "https://owlmeans.com/docs/mcp/reference/user-stories-and-planning-kits/"
lang: "en"
---

# User stories and planning kits

![](https://owlmeans.com/_astro/mcp-reference-user-stories-and-planning-kits.Iz3DpEX8_Z28ricJ.webp)

Use a focused story for behavior you can try and a planning kit when it fits the project.

## Use these tools

1.  Call the relevant read or status tool first.
2.  Review the target and required arguments.
3.  Run one intended action, with explicit human confirmation where required.
4.  Inspect status or re-read the affected resource afterward.

Inputs below describe the public contract. Your connected server’s current tool list is authoritative. Some tools require a particular host, target, inference mode or plan. Identifiers are values returned by earlier tools; do not invent them.

## `describe_planning_kits`

The planning kits a project can take.

Read the returned resource and use its current values when planning the next action.

| Argument | Required | Type or accepted values |
| --- | --- | --- |
| `projectId` | No | string |

**Operation:** read-only.

**Available setups:** stdio, cloud project, cloud inference; stdio, cloud project, delegated inference; stdio, local project, cloud inference; stdio, local project, delegated inference; hosted HTTP.

The [machine-readable tool contracts](https://owlmeans.com/docs/mcp/tools.json) include nested argument schemas.

## `apply_planning_kit`

Write a planning kit into the project.

Read describe\_planning\_kits first and choose a supported kit and type set. Review the stories written afterward.

| Argument | Required | Type or accepted values |
| --- | --- | --- |
| `projectId` | No | string |
| `kit` | Yes | string; minLength 1 |
| `types` | No | array of string |

**Operation:** can change state or start work.

**Available setups:** stdio, cloud project, cloud inference; stdio, cloud project, delegated inference; stdio, local project, cloud inference; stdio, local project, delegated inference; hosted HTTP.

The [machine-readable tool contracts](https://owlmeans.com/docs/mcp/tools.json) include nested argument schemas.

## `list_stories`

The user stories of a project.

Read the returned resource and use its current values when planning the next action.

| Argument | Required | Type or accepted values |
| --- | --- | --- |
| `projectId` | No | string |
| `page` | No | integer; minimum 0; maximum 9007199254740991 |
| `size` | No | integer; minimum 1; maximum 100 |
| `status` | No | string |
| `area` | No | string |

**Operation:** read-only.

**Available setups:** stdio, cloud project, cloud inference; stdio, cloud project, delegated inference; stdio, local project, cloud inference; stdio, local project, delegated inference; hosted HTTP.

The [machine-readable tool contracts](https://owlmeans.com/docs/mcp/tools.json) include nested argument schemas.

## `search_stories`

Find a story.

Read the returned resource and use its current values when planning the next action.

| Argument | Required | Type or accepted values |
| --- | --- | --- |
| `q` | Yes | string; minLength 1 |
| `projectId` | No | string |

**Operation:** read-only.

**Available setups:** stdio, cloud project, cloud inference; stdio, cloud project, delegated inference; stdio, local project, cloud inference; stdio, local project, delegated inference; hosted HTTP.

The [machine-readable tool contracts](https://owlmeans.com/docs/mcp/tools.json) include nested argument schemas.

## `create_story`

Add a user story.

Read the returned resource and use its current values when planning the next action.

| Argument | Required | Type or accepted values |
| --- | --- | --- |
| `story` | Yes | string; minLength 1 |
| `projectId` | No | string |

**Operation:** can change state or start work.

**Available setups:** stdio, cloud project, cloud inference; stdio, cloud project, delegated inference; stdio, local project, cloud inference; stdio, local project, delegated inference; hosted HTTP.

The [machine-readable tool contracts](https://owlmeans.com/docs/mcp/tools.json) include nested argument schemas.

## `update_story`

Reword a user story.

Read the returned resource and use its current values when planning the next action.

| Argument | Required | Type or accepted values |
| --- | --- | --- |
| `storyId` | Yes | string |
| `story` | Yes | string; minLength 1 |
| `projectId` | No | string |

**Operation:** can change state or start work.

**Available setups:** stdio, cloud project, cloud inference; stdio, cloud project, delegated inference; stdio, local project, cloud inference; stdio, local project, delegated inference; hosted HTTP.

The [machine-readable tool contracts](https://owlmeans.com/docs/mcp/tools.json) include nested argument schemas.

## `delete_story`

Remove a user story.

Removes the planning story. Review the card before deletion; removing a story is not a promise to reverse existing application code.

| Argument | Required | Type or accepted values |
| --- | --- | --- |
| `storyId` | Yes | string |
| `projectId` | No | string |

**Operation:** can change state or start work; destructive effects are possible.

**Available setups:** stdio, cloud project, cloud inference; stdio, cloud project, delegated inference; stdio, local project, cloud inference; stdio, local project, delegated inference; hosted HTTP.

The [machine-readable tool contracts](https://owlmeans.com/docs/mcp/tools.json) include nested argument schemas.

## `develop_story`

Implement a user story.

Starts development once for the chosen story. Follow story\_status and check the preview result.

| Argument | Required | Type or accepted values |
| --- | --- | --- |
| `storyId` | Yes | string |
| `projectId` | No | string |

**Operation:** can change state or start work.

**Available setups:** stdio, cloud project, cloud inference; stdio, cloud project, delegated inference; stdio, local project, cloud inference; stdio, local project, delegated inference; hosted HTTP.

The [machine-readable tool contracts](https://owlmeans.com/docs/mcp/tools.json) include nested argument schemas.

## `reset_story`

Put a story back to planned.

Changes the story back to planned. Review the current app before starting it again.

| Argument | Required | Type or accepted values |
| --- | --- | --- |
| `storyId` | Yes | string |
| `projectId` | No | string |

**Operation:** can change state or start work.

**Available setups:** stdio, cloud project, cloud inference; stdio, cloud project, delegated inference; stdio, local project, cloud inference; stdio, local project, delegated inference; hosted HTTP.

The [machine-readable tool contracts](https://owlmeans.com/docs/mcp/tools.json) include nested argument schemas.

## `complete_story`

Mark a story as completed.

Updates the planning state. Verify the implemented behavior; this action itself does not implement missing code.

| Argument | Required | Type or accepted values |
| --- | --- | --- |
| `storyId` | Yes | string |
| `projectId` | No | string |

**Operation:** can change state or start work.

**Available setups:** stdio, cloud project, cloud inference; stdio, cloud project, delegated inference; stdio, local project, cloud inference; stdio, local project, delegated inference; hosted HTTP.

The [machine-readable tool contracts](https://owlmeans.com/docs/mcp/tools.json) include nested argument schemas.

## `story_status`

What happened to a story.

Read the returned resource and use its current values when planning the next action.

| Argument | Required | Type or accepted values |
| --- | --- | --- |
| `storyId` | Yes | string |
| `projectId` | No | string |

**Operation:** read-only.

**Available setups:** stdio, cloud project, cloud inference; stdio, cloud project, delegated inference; stdio, local project, cloud inference; stdio, local project, delegated inference; hosted HTTP.

The [machine-readable tool contracts](https://owlmeans.com/docs/mcp/tools.json) include nested argument schemas.

## Related reference

[MCP home](https://owlmeans.com/docs/mcp) · [Recovery workflow](https://owlmeans.com/docs/mcp/workflows/review-answer-questions-and-resume-development) · [Costs](https://owlmeans.com/docs/help/how-ai-work-and-inference-costs-are-calculated)
