MantisBT MCP Server

A Model Context Protocol (MCP) server that integrates the MantisBT REST API into Claude Code and other MCP-capable clients. Read, create, and update issues directly from your editor.

Local serverstdioMIT

What is the MantisBT MCP Server?

MantisBT MCP Server is an MCP project maintained in the dpesch/mantisbt-mcp-server repository. The maintainer describes its purpose as “A Model Context Protocol (MCP) server that integrates the MantisBT REST API into Claude Code and other MCP-capable clients. Read, create, and update issues directly…”. Read the project documentation for the complete scope.

Installation

The documented npm package is @dpesch/mantisbt-mcp-server. The configuration below comes from the maintainer’s example; adapt its paths and account values to your environment.

Configuration values

The example declares MANTIS_BASE_URL, MANTIS_API_KEY. Secret-looking values have been replaced with placeholders. Required and optional labels are shown only when the documentation states them.

Source

Project documentation · Repository · Discovery listing. This profile records the public documentation checked on 2026-10-08.

Recorded tools

Check the linked publisher documentation and your connected client's tool list. Names and availability can vary with the server version and account permissions.

ToolWhat it does
get_issueRetrieve an issue by its numeric ID; optional select for field projection to reduce response size
get_issuesRetrieve multiple issues by ID in one call (1–50 IDs); missing or inaccessible IDs return null at their position instead of failing the call
list_issuesFilter issues by project, status, author, and more; optional select for field projection and status for client-side status filtering — canonical English status
create_issueCreate a new issue; severity and priority must be canonical English names (e.g. minor, major, normal, high) — call get_issue_enums to see all valid values…
update_issueUpdate an existing issue; enum fields (status, priority, severity, resolution, reproducibility) accept canonical English names, localized names, or numeric IDs
delete_issueDelete an issue
list_notesList all notes of an issue
add_noteAdd a note to an issue
delete_noteDelete a note
list_issue_filesList attachments of an issue
upload_fileUpload a file to an issue — preferred: local file_path (server reads and encodes automatically); fallback: Base64-encoded content + filename (use only when…
add_relationshipCreate a relationship between two issues; optional type_name parameter accepts a string name (e.g. "related_to", "duplicate_of") as alternative to numeric…
remove_relationshipRemove a relationship from an issue (use the id from the relationship object, not the type)
add_monitorAdd a user as a monitor of an issue
remove_monitorRemove a user as a monitor of an issue
list_tagsList all available tags; falls back to the metadata cache when GET /tags returns 404 (run sync_metadata first to populate)
attach_tagsAttach tags to an issue
detach_tagRemove a tag from an issue
list_projectsList all accessible projects; returns normalized project data (consistent with sync_metadata cache)
get_project_versionsGet versions of a project; optional obsolete and inherit booleans to include obsolete or parent-inherited versions; each version includes a timestamp field…
create_versionCreate a new version in a project; returns the created version object (id, name, description, released, obsolete, timestamp); requires manage_project_threshold
update_versionUpdate an existing version; only the fields you pass are changed (at least one required); renaming rewrites version/target_version/fixed_in_version on all…
release_versionMark a version as released and set its date (default: now); optionally create a follow-up version in the same step via next_version; requires…
delete_versionPermanently delete a version — irreversible, MantisBT clears version/target_version/fixed_in_version on all referencing issues; prefer update_version with…
get_project_categoriesGet categories of a project
get_project_usersGet users of a project
find_project_memberSearch project members by name, real name, or email (case-insensitive substring match); optional query and limit (default 10, max 100); cache-first
search_issuesNatural language search over all indexed issues — returns top-N results with cosine similarity score; optional select (comma-separated field names) enriches…
rebuild_search_indexBuild or update the search index; full: true clears and rebuilds from scratch
get_search_index_statusReturn the current fill level of the search index: how many issues are indexed vs. total, and the timestamp of the last sync
DependenciesNone (pure JS)
InstallIncluded
PerformanceFast enough for most setups

How to install the MantisBT MCP Server

{
  "mcpServers": {
    "mantisbt": {
      "command": "npx",
      "args": [
        "-y",
        "@dpesch/mantisbt-mcp-server"
      ],
      "env": {
        "MANTIS_BASE_URL": "https://your-mantis.example.com/api/rest",
        "MANTIS_API_KEY": "YOUR_MANTIS_API_KEY"
      }
    }
  }
}

From the project documentation. Replace placeholders and example paths before connecting.

Configuration

VariableDescriptionRequired
MANTIS_BASE_URLDeclared in the maintainer’s client configuration.Check documentation
MANTIS_API_KEYDeclared in the maintainer’s client configuration.Check documentation