create_mr_discussion_note

Add a note to an existing merge request discussion thread to provide feedback, ask questions, or continue conversations about code changes.

Instructions

Add a new note to an existing merge request discussion thread

Input Schema

TableJSON Schema

Name	Required	Description
`project_id`	Yes	Project ID or path
`merge_request_iid`	Yes	Merge request internal ID
`discussion_id`	Yes	The ID of the discussion to add the note to
`body`	Yes	The content of the note (supports Markdown)

Implementation Reference

src/handlers/merge-requests.ts:541-557 (handler)

The main handler function that executes the tool logic by posting a new note to the specified GitLab MR discussion endpoint.

async createMRDiscussionNote(args: CreateMRDiscussionNoteParams) {
  const data = await this.client.post(
    `/projects/${encodeURIComponent(args.project_id)}/merge_requests/${
      args.merge_request_iid
    }/discussions/${args.discussion_id}/notes`,
    { body: args.body }
  );

  return {
    content: [
      {
        type: "text",
        text: JSON.stringify(data, null, 2),
      },
    ],
  };
}

src/types.ts:529-534 (schema)

TypeScript interface defining the input parameters for the create_mr_discussion_note tool.

export interface CreateMRDiscussionNoteParams {
  project_id: string;
  merge_request_iid: number;
  discussion_id: string;
  body: string;
}

src/tools/merge-requests.ts:570-594 (registration)

Tool registration in the mergeRequestTools array, including name, description, and inputSchema.

  name: 'create_mr_discussion_note',
  description: 'Add a new note to an existing merge request discussion thread',
  inputSchema: {
    type: 'object',
    properties: {
      project_id: {
        type: 'string',
        description: 'Project ID or path',
      },
      merge_request_iid: {
        type: 'number',
        description: 'Merge request internal ID',
      },
      discussion_id: {
        type: 'string',
        description: 'The ID of the discussion to add the note to',
      },
      body: {
        type: 'string',
        description: 'The content of the note (supports Markdown)',
      },
    },
    required: ['project_id', 'merge_request_iid', 'discussion_id', 'body'],
  },
},

src/server.ts:239-242 (registration)

Dispatch case in the server tool handler switch statement that routes calls to the merge request handler.

case "create_mr_discussion_note":
  return await this.mergeRequestHandlers.createMRDiscussionNote(
    args as unknown as CreateMRDiscussionNoteParams
  );

GitLab MCP Server