mcp-bugzilla

šŸ§° Tools

Full reference for all 17 mcp-bugzilla tools ā€” bugs, comments, attachments, products, users, fields, and flags.

mcp-bugzilla exposes 17 tools across six areas. Tools marked šŸ”‘ require MCP_BUGZILLA_API_KEY; the rest work read-only.

šŸ› Bugs

get_bug

Fetch a single bug by ID or alias.

ParameterTypeRequiredDescription
idstringyesBug ID or alias

search_bugs

Search Bugzilla bugs with filters. Use quicksearch for full-text queries.

ParameterTypeRequiredDescription
productstringnoProduct name (e.g. Firefox)
componentstringnoComponent name
statusstringnoBug status (NEW, ASSIGNED, RESOLVED, etc.)
severitystringnoSeverity (blocker, critical, major, normal, minor, trivial)
prioritystringnoPriority (P1, P2, P3, P4, P5)
assigned_tostringnoAssignee email
creatorstringnoReporter email
resolutionstringnoResolution (FIXED, WONTFIX, DUPLICATE, etc.)
summarystringnoText to search in summary
keywordsstringnoComma-separated keywords
quicksearchstringnoQuicksearch query string (full-text)
limitnumbernoMax results (1ā€“500, default 20)
offsetnumbernoPagination offset

create_bug šŸ”‘

File a new bug. Requires MCP_BUGZILLA_API_KEY.

ParameterTypeRequiredDescription
productstringyesProduct name
componentstringyesComponent name
summarystringyesOne-line bug summary
versionstringyesProduct version affected
typeenumnodefect, enhancement, or task
descriptionstringnoDetailed description
severitystringnoSeverity level
prioritystringnoPriority level
op_sysstringnoOperating system
platformstringnoHardware platform
assigned_tostringnoAssignee email
ccstring[]noCC list (emails)
keywordsstring[]noKeywords
statusstringnoInitial status
target_milestonestringnoTarget milestone

update_bug šŸ”‘

Update fields on an existing bug. Requires MCP_BUGZILLA_API_KEY.

ParameterTypeRequiredDescription
idstringyesBug ID or alias to update
statusstringnoNew status
resolutionstringnoResolution (when closing)
assigned_tostringnoNew assignee email
prioritystringnoNew priority
severitystringnoNew severity
summarystringnoNew summary
whiteboardstringnoWhiteboard text
keywordsobjectnoKeyword changes (add/remove/set)
ccobjectnoCC list changes (add/remove)
commentobjectnoComment to attach (body, is_private)
dupe_ofnumbernoMark as duplicate of this bug ID

get_bug_history

Get the field-change history for a bug.

ParameterTypeRequiredDescription
idstringyesBug ID or alias

šŸ’¬ Comments

get_comments

Get all comments for a bug.

ParameterTypeRequiredDescription
idstringyesBug ID or alias
new_sincestringnoISO 8601 datetime ā€” only comments newer than this

create_comment šŸ”‘

Post a comment on a bug. Requires MCP_BUGZILLA_API_KEY.

ParameterTypeRequiredDescription
idstringyesBug ID or alias
commentstringyesComment text
is_privatebooleannoPrivate comment (default false)
work_timenumbernoHours worked to log against the bug

search_comment_tags

Search for comment tag names by substring.

ParameterTypeRequiredDescription
querystringyesSubstring to search for in tag names
limitnumbernoMax results (default 10)

update_comment_tags šŸ”‘

Add or remove tags on a comment (e.g. mark as spam or needinfo). Requires MCP_BUGZILLA_API_KEY.

ParameterTypeRequiredDescription
comment_idstringyesComment ID to tag
addstring[]noTags to add
removestring[]noTags to remove

šŸ“Ž Attachments

get_attachments

List attachments (patches, screenshots, logs) for a bug.

ParameterTypeRequiredDescription
idstringyesBug ID or alias

create_attachment šŸ”‘

Upload a patch or file to a bug. data must be base64-encoded. Requires MCP_BUGZILLA_API_KEY.

ParameterTypeRequiredDescription
idstringyesBug ID to attach to
datastringyesBase64-encoded file content
file_namestringyesDisplay filename (e.g. fix.patch)
summarystringyesBrief description of the attachment
content_typestringyesMIME type (e.g. text/plain)
commentstringnoComment to post with the attachment
is_patchbooleannoMark as a code patch (default false)
is_privatebooleannoPrivate attachment (default false)
flagsobject[]noFlags to set (name, status, requestee)

update_attachment šŸ”‘

Update an existing attachment ā€” rename, mark obsolete, change flags. Requires MCP_BUGZILLA_API_KEY.

ParameterTypeRequiredDescription
attachment_idstringyesAttachment ID to update
file_namestringnoNew filename
summarystringnoNew description
content_typestringnoNew MIME type
is_patchbooleannoSet patch status
is_privatebooleannoSet private status
is_obsoletebooleannoMark as obsolete (superseded)
commentstringnoComment to post with the update
flagsobject[]noFlag changes (name, status, requestee)

šŸ“¦ Products

get_products

List Bugzilla products.

ParameterTypeRequiredDescription
typeenumnoaccessible (default), selectable, or enterable

get_product

Get product details including components and versions.

ParameterTypeRequiredDescription
namestringyesProduct name (e.g. Firefox)

šŸ‘¤ Users

get_user

Look up a Bugzilla user by email or login name.

ParameterTypeRequiredDescription
namestringyesUser email or login name

šŸ”– Fields & Flags

get_bug_fields

List bug fields and their legal values.

ParameterTypeRequiredDescription
field_namestringnoSpecific field to inspect (e.g. status, severity)

get_flag_types

List available flags for a product/component (e.g. review, needinfo, approval-mozilla-beta).

ParameterTypeRequiredDescription
productstringyesProduct name (e.g. Firefox)
componentstringnoComponent name to narrow results

šŸ“¦ Installation

Install and register mcp-bugzilla with Claude Code, Claude Desktop, Cursor, Windsurf, or VSCode.

āš” Usage

Example conversations showing how an AI assistant drives mcp-bugzilla against real Firefox/Mozilla bugs.

On this page

šŸ› Bugsget_bugsearch_bugscreate_bug šŸ”‘update_bug šŸ”‘get_bug_historyšŸ’¬ Commentsget_commentscreate_comment šŸ”‘search_comment_tagsupdate_comment_tags šŸ”‘šŸ“Ž Attachmentsget_attachmentscreate_attachment šŸ”‘update_attachment šŸ”‘šŸ“¦ Productsget_productsget_productšŸ‘¤ Usersget_useršŸ”– Fields & Flagsget_bug_fieldsget_flag_types