create_project_card
Add a new card with note content to a specified column in a GitHub project to organize tasks and track progress.
Instructions
Create a new card in a project column
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| column_id | Yes | The ID of the column | |
| note | Yes | The note content for the card |
Implementation Reference
- src/operations/projects.ts:199-218 (handler)The main handler function implementing the logic to create a GitHub project card via API request.
export async function createProjectCard( github_pat: string, column_id: number, note: string ): Promise<z.infer<typeof ProjectCardSchema>> { const response = await githubRequest( github_pat, `https://api.github.com/projects/columns/${column_id}/cards`, { method: "POST", body: { note, }, headers: { "Accept": "application/vnd.github.inertia-preview+json", }, } ); return ProjectCardSchema.parse(response); } - src/operations/projects.ts:91-94 (schema)Input schema definition for the create_project_card tool (public version without github_pat).
export const CreateProjectCardSchema = z.object({ column_id: z.number().describe("The ID of the column"), note: z.string().describe("The note content for the card"), }); - src/operations/projects.ts:96-98 (schema)Extended input schema including github_pat used for parsing in the handler.
export const _CreateProjectCardSchema = CreateProjectCardSchema.extend({ github_pat: z.string().describe("GitHub Personal Access Token"), }); - src/index.ts:269-273 (registration)Tool registration in the MCP tools array with name, description, and input schema.
{ name: "create_project_card", description: "Create a new card in a project column", inputSchema: zodToJsonSchema(projects.CreateProjectCardSchema), }, - src/index.ts:721-728 (handler)Dispatcher handler case that validates arguments and delegates to the projects.createProjectCard function.
case "create_project_card": { const args = projects._CreateProjectCardSchema.parse(params.arguments); const { github_pat, column_id, note } = args; const result = await projects.createProjectCard(github_pat, column_id, note); return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }], }; }