create_repository
Create a new GitHub repository with specified name, description, visibility, and README initialization directly through the GitHub MCP Server interface.
Instructions
Create a new GitHub repository in your account
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| autoInit | No | Initialize with README.md | |
| description | No | Repository description | |
| name | Yes | Repository name | |
| private | No | Whether the repository should be private |
Implementation Reference
- operations/repository.ts:29-35 (handler)The main handler function that executes the tool logic by making a POST request to GitHub's /user/repos endpoint with the provided options and parsing the response.
export async function createRepository(options: CreateRepositoryOptions) { const response = await githubRequest("https://api.github.com/user/repos", { method: "POST", body: options, }); return GitHubRepositorySchema.parse(response); } - operations/repository.ts:6-11 (schema)Zod schema defining the input parameters for the create_repository tool.
export const CreateRepositoryOptionsSchema = z.object({ name: z.string().describe("Repository name"), description: z.string().optional().describe("Repository description"), private: z.boolean().optional().describe("Whether the repository should be private"), autoInit: z.boolean().optional().describe("Initialize with README.md"), }); - index.ts:80-84 (registration)Registration of the tool in the MCP server's listTools handler, including name, description, and input schema.
{ name: "create_repository", description: "Create a new GitHub repository in your account", inputSchema: zodToJsonSchema(repository.CreateRepositoryOptionsSchema), }, - index.ts:349-355 (handler)Dispatch handler in the CallToolRequestSchema that validates arguments and calls the createRepository function.
case "create_repository": { const args = repository.CreateRepositoryOptionsSchema.parse(request.params.arguments); const result = await repository.createRepository(args); return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }], }; }