create_wiki
Create a new wiki in Azure DevOps projects to document processes, share knowledge, and organize team information.
Instructions
Create a new wiki
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| name | Yes | Wiki name | |
| projectId | No | Project ID (optional, defaults to current project) | |
| mappedPath | No | Mapped path (optional, defaults to /) |
Implementation Reference
- src/tools/wiki/create.ts:12-47 (handler)The core handler function implementing the create_wiki tool logic: validates input, initializes Azure DevOps connection, creates wiki via API, handles errors, and formats MCP response.
export async function createWiki(args: CreateWikiArgs, config: AzureDevOpsConfig) { if (!args.name) { throw new McpError(ErrorCode.InvalidParams, 'Wiki name is required'); } AzureDevOpsConnection.initialize(config); const connection = AzureDevOpsConnection.getInstance(); const wikiApi = await connection.getWikiApi(); try { const wikiCreateParams = { name: args.name, projectId: args.projectId || config.project, mappedPath: args.mappedPath || '/', type: WikiType.ProjectWiki, }; const wiki = await wikiApi.createWiki(wikiCreateParams, config.project); return { content: [ { type: 'text', text: JSON.stringify(wiki, null, 2), }, ], }; } catch (error: unknown) { if (error instanceof McpError) throw error; const errorMessage = error instanceof Error ? error.message : 'Unknown error'; throw new McpError( ErrorCode.InternalError, `Failed to create wiki: ${errorMessage}` ); } } - src/tools/wiki/index.ts:42-62 (schema)MCP input schema definition for the create_wiki tool, including properties, descriptions, and required fields.
{ name: 'create_wiki', description: 'Create a new wiki', inputSchema: { type: 'object', properties: { name: { type: 'string', description: 'Wiki name', }, projectId: { type: 'string', description: 'Project ID (optional, defaults to current project)', }, mappedPath: { type: 'string', description: 'Mapped path (optional, defaults to /)', }, }, required: ['name'], }, - src/tools/wiki/index.ts:97-98 (registration)Registration of the createWiki handler within the wikiTools module, wrapping the core createWiki function.
createWiki: (args: { name: string; projectId?: string; mappedPath?: string }) => createWiki(args, config), - src/index.ts:145-146 (registration)Top-level tool dispatch registration in the main server switch statement.
case 'create_wiki': result = await tools.wiki.createWiki(request.params.arguments); - src/tools/wiki/create.ts:6-10 (schema)TypeScript interface defining arguments for createWiki, matching the tool schema.
interface CreateWikiArgs { name: string; projectId?: string; mappedPath?: string; }