create_issue
Create new issues in Bitbucket Cloud repositories to track bugs, enhancements, proposals, or tasks with specified titles, descriptions, types, and priorities.
Instructions
Create a new issue in a repository.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| workspace | Yes | The workspace slug | |
| repo_slug | Yes | The repository slug | |
| title | Yes | Issue title | |
| content | No | Issue content/description | |
| kind | No | Issue type | |
| priority | No | Priority level | |
| assignee | No | Assignee UUID |
Implementation Reference
- src/tools/index.ts:1034-1037 (handler)Main handler for the create_issue tool in ToolHandler.handleTool method. Parses input using Zod schema and delegates to IssuesAPI.create.
case 'create_issue': { const params = toolSchemas.create_issue.parse(args); return this.issues.create(params); } - src/tools/index.ts:214-225 (schema)Zod input schema for create_issue tool used for validation in the handler.
create_issue: z.object({ workspace: z.string().describe('The workspace slug'), repo_slug: z.string().describe('The repository slug'), title: z.string().describe('Issue title'), content: z.string().optional().describe('Issue content/description'), kind: z.enum(['bug', 'enhancement', 'proposal', 'task']).optional().describe('Issue type'), priority: z .enum(['trivial', 'minor', 'major', 'critical', 'blocker']) .optional() .describe('Priority level'), assignee: z.string().optional().describe('Assignee UUID'), }), - src/tools/index.ts:703-727 (registration)Registration of the create_issue tool in the toolDefinitions array, including name, description, and JSON inputSchema for MCP.
{ name: 'create_issue', description: 'Create a new issue in a repository.', inputSchema: { type: 'object' as const, properties: { workspace: { type: 'string', description: 'The workspace slug' }, repo_slug: { type: 'string', description: 'The repository slug' }, title: { type: 'string', description: 'Issue title' }, content: { type: 'string', description: 'Issue content/description' }, kind: { type: 'string', enum: ['bug', 'enhancement', 'proposal', 'task'], description: 'Issue type', }, priority: { type: 'string', enum: ['trivial', 'minor', 'major', 'critical', 'blocker'], description: 'Priority level', }, assignee: { type: 'string', description: 'Assignee UUID' }, }, required: ['workspace', 'repo_slug', 'title'], }, }, - src/api/issues.ts:35-53 (helper)IssuesAPI.create method that constructs the request body and makes POST to Bitbucket API to create the issue.
async create(params: CreateIssueParams): Promise<BitbucketIssue> { const { workspace, repo_slug, title, content, kind, priority, assignee } = params; const body: Record<string, unknown> = { title, }; if (content) { body.content = { raw: content }; } if (kind) body.kind = kind; if (priority) body.priority = priority; if (assignee) { body.assignee = { uuid: assignee }; } return this.client.post<BitbucketIssue>(`/repositories/${workspace}/${repo_slug}/issues`, body); } - src/types/index.ts:339-347 (schema)TypeScript interface defining CreateIssueParams used in API and tool.
export interface CreateIssueParams { workspace: string; repo_slug: string; title: string; content?: string; kind?: 'bug' | 'enhancement' | 'proposal' | 'task'; priority?: 'trivial' | 'minor' | 'major' | 'critical' | 'blocker'; assignee?: string; }