create_milestone
Create GitHub milestones to organize project timelines, track progress, and manage deliverables with clear due dates and descriptions.
Instructions
Create a new milestone
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| title | Yes | ||
| description | Yes | ||
| dueDate | No |
Implementation Reference
- Main handler function that executes the create_milestone tool logic by creating a GitHub milestone via the repository.
async createMilestone(data: { title: string; description: string; dueDate?: string; }): Promise<Milestone> { try { const milestoneData: CreateMilestone = { title: data.title, description: data.description, dueDate: data.dueDate, }; return await this.milestoneRepo.create(milestoneData); } catch (error) { throw this.mapErrorToMCPError(error); } } - Zod schema defining input validation for the create_milestone tool.
// Schema for create_milestone tool export const createMilestoneSchema = z.object({ title: z.string().min(1, "Milestone title is required"), description: z.string().min(1, "Milestone description is required"), dueDate: z.string().datetime("Due date must be a valid ISO date string").optional(), }); export type CreateMilestoneArgs = z.infer<typeof createMilestoneSchema>; - src/infrastructure/tools/ToolRegistry.ts:148-152 (registration)Registration of the create_milestone tool in the central ToolRegistry.
// Register milestone tools this.registerTool(createMilestoneTool); this.registerTool(listMilestonesTool); this.registerTool(updateMilestoneTool); this.registerTool(deleteMilestoneTool); - src/index.ts:262-263 (handler)MCP tool dispatch handler that routes create_milestone calls to the service implementation.
case "create_milestone": return await this.service.createMilestone(args); - ToolDefinition object for create_milestone including name, description, schema, and examples used for MCP tool listing.
export const createMilestoneTool: ToolDefinition<CreateMilestoneArgs> = { name: "create_milestone", description: "Create a new milestone", schema: createMilestoneSchema as unknown as ToolSchema<CreateMilestoneArgs>, examples: [ { name: "Create milestone with due date", description: "Create a milestone with title, description and due date", args: { title: "Beta Release", description: "Complete all features for beta release", dueDate: "2025-06-30T00:00:00Z" } } ] };