MantisBT MCP Server
About
MCP server for MantisBT REST API – read and manage bug tracker issues
Details
- Author
- dpesch
- Downloads
- 345
- Categories
- Other
Jump to
- Full issue lifecycle: create, read, update, delete issues and their notes, attachments, tags, and relationships
- Browse project metadata: list projects, versions, categories, and members
- Access saved filters, user profiles, and enum lookups (severity, status, priority, …)
- Optional semantic search: find issues by meaning, not just keywords, using a local offline embedding model (~80 MB, downloaded once)
Setting up with Highlight
This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:
- Download and install Highlight from highlightai.com/download
- Navigate to the plugins tab and select "Add Custom Plugin"
-
Configure the plugin with the settings below
Plugin Name
MantisBT MCP ServerCommand (node, npx, python, etc.)Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
- Enable "Start Automatically" if you want the plugin to start when Highlight launches
From the repository
Zero‑install setup via npx @dpesch/mantisbt-mcp-server — just configure the environment variables MANTIS_BASE_URL and MANTIS_API_KEY. The server supports stdio (default) and HTTP (Streamable HTTP) transports, with optional Bearer token authentication for remote or Docker deployments.
get_issue
Retrieve a single MantisBT issue by its numeric ID. Returns all issue fields including notes, attachments, and relationships (unless "select" is given). Notes are always included — no separate list_notes call needed.
get_issues
Retrieve multiple MantisBT issues by their numeric IDs in a single MCP call. Requests run in parallel (max 5 concurrent). Missing or inaccessible IDs return null at their array position — the call never fails due to individual missing IDs. Response includes "requested", "found", and "failed" counters for quick validation.
list_issues
List MantisBT issues with optional filtering. Returns a paginated list of issues. Use the "select" parameter to limit returned fields and reduce response size significantly. Note: "assigned_to", "reporter_id", "status", and date filters are applied client-side (the MantisBT REST API does not support these as server-side filters). When any of these filters are active the tool automatically fetches multiple pages internally until enough matching results are found (up to 500 issues scanned). The "page" and "page_size" parameters refer to the resulting filtered list. Tip for date queries: fetching with select="id,updated_at,created_at" plus a date filter is very compact and efficient.
create_issue
Create a new MantisBT issue. Returns the full created issue object including the assigned id, summary, status, priority, severity, category, reporter, created_at, and view_url. Required fields: summary, description, project_id, category. All other fields are optional with sensible defaults (priority: "normal", severity: "minor"). Recommended workflow: 1. Call get_project_categories to obtain a valid category name 2. Optionally call get_project_versions to obtain version names 3. Optionally call find_project_member to resolve the assignee's username Both priority and severity accept canonical English names or localized labels from the connected MantisBT instance — call get_issue_enums to see all available values. For the handler, prefer the username field (resolved server-side) over handler_id when working interactively.
update_issue
Update one or more fields of an existing MantisBT issue using a partial PATCH. The "fields" object accepts any combination of: - summary (string) - description (string) - steps_to_reproduce (string) - additional_information (string) - status: { name: "new"|"feedback"|"acknowledged"|"confirmed"|"assigned"|"resolved"|"closed" } - resolution: { id: 20 } (20 = fixed/resolved) - handler: { id: <user_id> } or { name: "<username>" } - priority: { name: "<priority_name>" } - severity: { name: "<severity_name>" } - reproducibility: { name: "<reproducibility_name>" } - category: { name: "<category_name>" } - version: { name: "<version_name>" } (affected version) - target_version: { name: "<version_name>" } - fixed_in_version: { name: "<version_name>" } - view_state: { name: "public"|"private" } - custom_fields: [{field: {id|name}, value: "<string>"}] (only the listed custom fields are changed, others stay untouched; use get_issue_fields to discover fields) Important: when resolving an issue, always set BOTH status and resolution to avoid leaving resolution as "open". Use the optional "note" parameter to append a note in the same call (e.g. the reason for a status change) — no separate add_note call needed. For a note without field changes use add_note.
delete_issue
Permanently delete a MantisBT issue. This action is irreversible.
list_notes
List all notes (comments) attached to a MantisBT issue. Note: get_issue already includes notes in its response — use list_notes only when you need notes without fetching the full issue.
add_note
Add a note (comment) to an existing MantisBT issue. Returns the created note object including id, created_at, reporter, text, view_state, and a view_url linking directly to the note in the MantisBT web UI. Full UTF-8 text is supported. Markdown syntax is stored as-is — rendering depends on the MantisBT instance's configured text renderer. Use view_state="private" to restrict the note to users with reporter-level access or higher; public notes are visible to all users who can view the issue. Prerequisites: obtain issue_id from list_issues, get_issue, or search_issues.
delete_note
Permanently delete a note from a MantisBT issue. This action is irreversible — deleted notes cannot be recovered. Returns a plain-text confirmation message on success. Returns an error if the note does not exist or the current user lacks permission to delete it (MantisBT enforces access control: users can typically only delete their own notes unless they have manager-level access or higher). Prerequisites: obtain note_id from list_notes or from get_issue (notes[].id); obtain issue_id from the same source.
list_issue_files
List all file attachments of a MantisBT issue. Returns an array of attachment objects, each containing id, filename, size in bytes, content_type, and download_url. Returns an empty array if the issue has no attachments. Use this tool when you need to inspect or enumerate files attached to an issue. To add a new attachment, use upload_file instead. To retrieve full issue details that include attachments alongside other fields, use get_issue instead.
upload_file
Upload a file as an attachment to a MantisBT issue. Adds the file to the issue without modifying any issue fields or status. Returns the created attachment metadata on success. Provide exactly one of the two input modes: - file_path (preferred): absolute path to a local file — use this whenever the file exists on disk; the server reads and encodes it automatically; filename is derived from the path. Note: file_path reads from the server's filesystem and is disabled over the HTTP transport unless MANTIS_UPLOAD_DIR is configured — HTTP clients should use content instead. - content: Base64-encoded file content — only use this when the file is not accessible via a path (e.g. in-memory data); filename must be supplied explicitly via the filename parameter The optional content_type sets the MIME type (e.g. "image/png"); defaults to "application/octet-stream". Use the optional description to annotate the attachment. Use this tool to attach files such as logs, screenshots, or patches to an existing issue. To list existing attachments, use list_issue_files. To retrieve issue details, use get_issue.
add_relationship
Add a relationship between two MantisBT issues. Relationship types — use either type_id (numeric) or type_name (string): - 0 / "duplicate_of" — this issue is a duplicate of target - 1 / "related_to" — this issue is related to target - 2 / "parent_of" — this issue depends on target (target must be done first); alias: "depends_on" - 3 / "child_of" — this issue blocks target (target can't proceed until this is done); alias: "blocks" - 4 / "has_duplicate" — this issue has target as a duplicate Directionality note: "A child_of B" means A blocks B. "A parent_of B" means A depends on B. Dash variants (e.g. "related-to") are also accepted for type_name.
remove_relationship
Remove a relationship from a MantisBT issue. Use get_issue first to retrieve the relationship IDs. The relationship_id is the numeric id field of a relationship object in the issue's relationships array (not the type ID).
add_monitor
Add a user as a monitor (watcher) of a MantisBT issue. Monitors receive email notifications whenever the issue is updated. Returns a success confirmation object. Use add_monitor to subscribe team members to issue updates without assigning them as the handler. To unsubscribe a user, call remove_monitor with the same parameters. Adding a user who is already a monitor is a no-op — the operation succeeds without creating duplicates. Prerequisites: obtain issue_id from list_issues or get_issue; use find_project_member or get_project_users to look up valid MantisBT login names.
remove_monitor
Remove a user from the monitor list of a MantisBT issue. The user will no longer receive email notifications for updates to this issue.
list_projects
List all MantisBT projects accessible to the current API user.
get_project_users
List all users with access to a specific MantisBT project. Returns an array of user objects, each containing id, name (login name), real_name, email, and access_level fields. Use get_project_users when you need the complete user list for a project — for example, to verify who has access or to build a handler list. For name-based lookup of a single user, prefer find_project_member which supports case-insensitive substring search and is significantly faster on large projects. Access level IDs: 10=viewer, 25=reporter, 40=updater, 55=developer, 70=manager, 90=administrator. Prerequisites: obtain project_id from list_projects.
get_project_versions
List all versions defined for a MantisBT project. Returns an array of version objects, each containing id, name, released (boolean), obsolete (boolean), and optionally a date field. Use the returned version names directly when creating or updating issues via create_issue and update_issue (version, target_version, fixed_in_version fields). By default, obsolete and inherited parent-project versions are excluded. Set obsolete=true to include deprecated versions; set inherit=true to also return versions from parent projects. Prerequisites: obtain project_id from list_projects.
get_project_categories
List all categories available for a MantisBT project. Note: The MantisBT API returns global (cross-project) categories with a "[All Projects] " prefix. This tool strips that prefix so the returned names can be used directly when creating issues.
find_project_member
Search for users with access to a MantisBT project by name, display name, or email. Returns up to `limit` matching users (default: 10, max: 100). Matching is case-insensitive substring search across `name`, `real_name`, and `email` fields. Omit `query` to list the first `limit` users. Data is served from the local metadata cache when fresh; falls back to a live API call otherwise.
get_current_user
Retrieve the profile of the user associated with the current API key.
list_filters
List all saved MantisBT issue filters accessible to the current user. Filter IDs can be used with list_issues.
get_config
Retrieve one or more MantisBT configuration options. Common option names: - "status_enum_string" — issue status values and their IDs - "priority_enum_string" — priority values - "severity_enum_string" — severity values - "resolution_enum_string" — resolution values - "reproducibility_enum_string" — reproducibility values - "view_state_enum_string" — view state values - "access_levels_enum_string" — access level values
get_issue_enums
Return valid ID, name, and (if available) localized label for all issue enum fields. Use this tool before creating or updating issues to look up the correct value for severity, status, priority, resolution, or reproducibility. Example response (English installation): { "severity": [{"id": 10, "name": "feature"}, {"id": 50, "name": "minor"}, ...], "status": [{"id": 10, "name": "new"}, {"id": 20, "name": "feedback"}, ...], "priority": [{"id": 10, "name": "none"}, {"id": 30, "name": "normal"}, ...], "resolution": [{"id": 10, "name": "open"}, {"id": 20, "name": "fixed"}, ...], "reproducibility": [{"id": 10, "name": "always"}, {"id": 70, "name": "have not tried"}, ...] } Example response (localized installation, e.g. German): { "status": [ {"id": 10, "name": "new", "label": "Neu"}, {"id": 20, "name": "feedback", "label": "Feedback"}, {"id": 30, "name": "acknowledged", "label": "Bestätigt"}, ... ], ... } Fields: - "id" — numeric ID accepted by the API - "name" — localized or canonical name from the MantisBT database - "label" — UI display label (only present when it differs from "name") - "canonical_name" — English canonical name (only present on localized installs) For create_issue (severity, priority, reproducibility): pass the canonical English name, the localized "name", or the "label" — all are accepted. The server resolves them to the correct ID. For update_issue: pass either "id" or "name" in the field reference object. Note: on some installations enum values are customized at the database level. In that case "name" itself may be localized (e.g. "kleinerer Fehler" instead of "minor") and no "label" will be present because there is no separate English original.
list_languages
List all languages supported by the MantisBT installation.
list_tags
List all tags defined in the MantisBT installation. The MantisBT REST API exposes a GET /tags endpoint on some installations. If that endpoint is not available, this tool falls back to the local metadata cache populated by sync_metadata.
sync_metadata
Fetch all projects and their associated users, versions, categories, and tags from MantisBT and store them in the local metadata cache. Tags are fetched via the dedicated GET /tags endpoint when available. On installations where that endpoint is missing (MantisBT < 2.26), tags are collected by scanning all issues across all projects. This is useful for getting a complete overview of your MantisBT installation. The cache is valid for 24 hours by default (configurable via MANTIS_CACHE_TTL env var). Use this tool to refresh stale data.
get_metadata
Return a compact summary of cached MantisBT metadata: project count, tag count, and per-project counts of users, versions, and categories. If the cache does not exist or has expired (default TTL: 24 hours), it will automatically sync first. Use sync_metadata to force a refresh. For full lists use: list_projects (projects), get_project_users / get_project_versions / get_project_categories (per-project data), list_tags (tags).
get_metadata_full
Return the complete raw MantisBT metadata cache: all projects with full fields, and per-project lists of users, versions, categories, plus all tags. If the cache does not exist or has expired (default TTL: 24 hours), it will automatically sync first. Use sync_metadata to force a refresh. For a lightweight overview use get_metadata instead.
get_issue_fields
Return all field names that are valid for the "select" parameter of list_issues and get_issue. Fields are discovered by fetching a sample issue from MantisBT (which reflects the server's active configuration — e.g. whether eta, projection, or profile fields are enabled) and merging the result with fields that MantisBT omits when empty (notes, attachments, relationships, etc.). The result is cached with the same TTL as the metadata cache. Use this tool before constructing a "select" string to ensure you only request fields that exist on this server.
attach_tags
Attach one or more tags to a MantisBT issue. Each tag can be specified either by ID or by name. If a tag name is provided that does not exist yet, MantisBT will create it automatically (requires tag_create_threshold permission, default: REPORTER). Requires tag_attach_threshold permission (default: REPORTER).
detach_tag
Remove a tag from a MantisBT issue. Requires tag_detach_own_threshold (default: REPORTER) for own tags, or tag_detach_threshold (default: DEVELOPER) for tags attached by others.
get_mcp_version
Returns the version of this mantisbt-mcp-server instance.
get_mantis_version
Returns the version of the connected MantisBT installation and optionally compares it against the latest official release on GitHub. The version is read from the X-Mantis-Version response header sent by every API call. The GitHub comparison requires an outbound HTTPS request to the GitHub API.
Claude Desktop / Cursor
Paste into your MCP client config file to install this server.
{
"mcpServers": {
"mantisbt mcp server": {
"mantisbt-mcp": {
"command": "npx",
"args": [
"@dpesch/mantisbt-mcp-server"
],
"env": {
"MANTIS_BASE_URL": "",
"MANTIS_API_KEY": ""
}
}
}
}
}McpServers
{
"mantisbt-mcp": {
"command": "npx",
"args": [
"@dpesch/mantisbt-mcp-server"
],
"env": {
"MANTIS_BASE_URL": "",
"MANTIS_API_KEY": ""
}
}
}MantisBT MCP Server connects your Mantis/MantisBT bug tracker to Claude Code and other MCP-compatible AI clients via the Model Context Protocol. Instead of switching between your editor and the browser, you can read, create, and update issues, notes, attachments, tags, and relationships directly from your AI assistant.
Core capabilities:
- Full issue lifecycle: create, read, update, delete issues; add and remove notes, attachments, tags, and relationships
- Project metadata: list projects, versions, categories, and members
- Saved filters, user profiles, and enum lookups (severity, status, priority, …)
- Optional semantic search: find issues by meaning, not just keywords — runs fully offline using a local embedding model (~80 MB, downloaded once)
Transport: stdio (default) and HTTP (Streamable HTTP) for remote/Docker setups, with optional Bearer token authentication.
Setup: zero install via npx @dpesch/mantisbt-mcp-server — just add your MANTIS_BASE_URL and MANTIS_API_KEY.
Requires MantisBT 2.23+ with REST API enabled.
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.
