USAGE_EXAMPLES.md•3.13 kB
# Shortcut MCP Usage Examples
## Creating Stories with Smart Defaults
### Quick Bug Creation
```javascript
// Minimal bug creation - smart defaults handle the rest
{
"name": "Login button not working on mobile",
"story_type": "bug",
"project_id": 984
}
// This automatically:
// - Adds 🐞 prefix to title
// - Sets "🧐 Investigate" label
// - Assigns to bugs epic (27912)
// - Sets medium priority
// - Sets deadline to next business day
// - Uses bug template
```
### Bug with Full Details
```javascript
{
"name": "Membership failed to renew",
"story_type": "bug",
"project_id": 984,
"description": "Customer's monthly membership failed to renew despite successful payment in Stripe",
"custom_fields": [{
"field_id": "6260465b-2009-456c-b2fe-ce32bb284231",
"value_id": "6260465b-9ae6-4667-88d6-51f634f75d6b" // Highest priority
}],
"labels": [
{ "name": "🐞 BASH" },
{ "name": "Intercom" }
],
"owner_ids": ["67dcb4a6-78df-4429-ac52-067b0b25e7f8"],
"external_links": ["https://www.loom.com/share/example"]
}
```
### Feature Story
```javascript
{
"name": "Add bulk export functionality",
"story_type": "feature",
"project_id": 984,
"description": "Allow users to export multiple records at once",
"estimate": 5,
"epic_id": 12345,
"owner_ids": ["user-uuid-here"]
}
```
## Common Patterns
### Kiosk Issues
```javascript
{
"name": "iPad touch target misalignment", // "Kiosk" label auto-added
"story_type": "bug",
"project_id": 986,
"description": "Kiosk is selecting wrong items when tapping"
}
```
### Audience/Tag Issues
```javascript
{
"name": "Tag scrolling broken in audience creation", // Both labels auto-added
"story_type": "bug",
"project_id": 984,
"description": "Cannot scroll through all available tags when creating an audience"
}
```
## Using Custom Fields
### Priority Levels
```javascript
// Highest Priority
"custom_fields": [{
"field_id": "6260465b-2009-456c-b2fe-ce32bb284231",
"value_id": "6260465b-9ae6-4667-88d6-51f634f75d6b"
}]
// Medium Priority (default for bugs)
"custom_fields": [{
"field_id": "6260465b-2009-456c-b2fe-ce32bb284231",
"value_id": "6260465b-552c-4138-83ec-a52cb9f6f4f5"
}]
// Low Priority
"custom_fields": [{
"field_id": "6260465b-2009-456c-b2fe-ce32bb284231",
"value_id": "6260465b-a812-4a6d-8e71-4dce16aed4f5"
}]
```
## Workflow States
The MCP automatically selects the appropriate default state, but you can override:
```javascript
// Development Workflow States
{
"workflow_state_id": 500000008, // Icebox (default)
"workflow_state_id": 500000249, // On Deck
"workflow_state_id": 500000007, // Backlog
"workflow_state_id": 500000006, // In Progress
// ... etc
}
```
## Tips
1. **Let smart defaults work for you**: Start with minimal required fields and add only what's different from defaults
2. **Bug titles**: Don't add 🐞 manually - it's added automatically
3. **Labels**: Common labels are detected from content automatically
4. **Deadlines**: Bugs get next business day deadline by default
5. **Templates**: Bug template is applied automatically to bug stories