MantisBT MCP Server

by dpeschio.github.dpesch/mantisbt-mcp-serverv1.14.0

MantisBT MCP server – manage issues, notes, files, tags, and relationships. With semantic search.

11Node.jsstdioofficial registry

context tax

queued

security

queued

cold start

queued

freshness

Active12d ago

Install MantisBT MCP server

claude mcp add mantisbt -e MANTIS_BASE_URL='<mantis-base-url>' -e MANTIS_API_KEY='<mantis-api-key>' -e MCP_HTTP_TOKEN='<mcp-http-token>' -- npx -y @dpesch/mantisbt-mcp-server

{
  "mcpServers": {
    "mantisbt": {
      "command": "npx",
      "args": [
        "-y",
        "@dpesch/mantisbt-mcp-server"
      ],
      "env": {
        "MANTIS_BASE_URL": "<mantis-base-url>",
        "MANTIS_API_KEY": "<mantis-api-key>",
        "MCP_HTTP_TOKEN": "<mcp-http-token>"
      }
    }
  }
}

Add to ~/.cursor/mcp.json (global) or .cursor/mcp.json (project).

{
  "mcpServers": {
    "mantisbt": {
      "command": "npx",
      "args": [
        "-y",
        "@dpesch/mantisbt-mcp-server"
      ],
      "env": {
        "MANTIS_BASE_URL": "<mantis-base-url>",
        "MANTIS_API_KEY": "<mantis-api-key>",
        "MCP_HTTP_TOKEN": "<mcp-http-token>"
      }
    }
  }
}

Settings → Developer → Edit Config (claude_desktop_config.json), then restart.

{
  "servers": {
    "mantisbt": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@dpesch/mantisbt-mcp-server"
      ],
      "env": {
        "MANTIS_BASE_URL": "<mantis-base-url>",
        "MANTIS_API_KEY": "<mantis-api-key>",
        "MCP_HTTP_TOKEN": "<mcp-http-token>"
      }
    }
  }
}

Add to .vscode/mcp.json in your workspace.

{
  "mcpServers": {
    "mantisbt": {
      "command": "npx",
      "args": [
        "-y",
        "@dpesch/mantisbt-mcp-server"
      ],
      "env": {
        "MANTIS_BASE_URL": "<mantis-base-url>",
        "MANTIS_API_KEY": "<mantis-api-key>",
        "MCP_HTTP_TOKEN": "<mcp-http-token>"
      }
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json.

Configuration

Variable	Required	Secret	Description
MANTIS_BASE_URL	yes	—	Base URL of the MantisBT REST API, e.g. https://your-mantis.example.com/api/rest
MANTIS_API_KEY	yes	yes	MantisBT API key (Profile → API Tokens in MantisBT)
MANTIS_USE_INDEX_PHP	—	—	Use /api/rest/index.php/ for MantisBT installations without URL rewriting. Detected automatically when MANTIS_BASE_URL ends with /api/rest/index.php
MANTIS_CACHE_DIR	—	—	Directory for the metadata cache. Defaults to ~/.cache/mantisbt-mcp
MANTIS_CACHE_TTL	—	—	Metadata cache TTL in seconds. Default: 3600 (1 hour)
TRANSPORT	—	—	Transport mode. 'stdio' for local use (default), 'http' for remote/team deployments
PORT	—	—	HTTP port when TRANSPORT=http. Default: 3000
MCP_HTTP_HOST	—	—	Bind address when TRANSPORT=http. Default: 127.0.0.1 (local only). Use 0.0.0.0 for Docker/remote.
MCP_HTTP_TOKEN	—	yes	Optional Bearer token to protect the /mcp endpoint when TRANSPORT=http
MANTIS_SEARCH_ENABLED	—	—	Enable offline semantic search (requires ~80 MB model download on first use)
MANTIS_SEARCH_BACKEND	—	—	Vector store backend for semantic search. 'vectra' (default, pure JS) or 'sqlite-vec' (faster for >10k issues)
MANTIS_SEARCH_DIR	—	—	Directory for the semantic search index. Defaults to ~/.cache/mantisbt-mcp/search
MANTIS_SEARCH_MODEL	—	—	Hugging Face model for embeddings. Default: Xenova/paraphrase-multilingual-MiniLM-L12-v2
MANTIS_SEARCH_THREADS	—	—	ONNX inference threads for the embedding model. Default: 1
MANTIS_UPLOAD_DIR	—	—	If set, restricts file uploads to this directory (path traversal protection)

Freshness

Active — last maintenance signal 12d ago. The newest of the signals below sets the band.

Last commit (default branch)
2026-09-27 · 12d ago · GitHub
Latest release
2026-09-27 · 12d ago · GitHub · v1.14.0
Package published
no data · npm/PyPI
Registry entry updated
2026-09-27 · 12d ago · official registry · v1.14.0

FAQ

›How do I install the MantisBT MCP server in Claude Code?

Run: claude mcp add mantisbt -e MANTIS_BASE_URL='<mantis-base-url>' -e MANTIS_API_KEY='<mantis-api-key>' -e MCP_HTTP_TOKEN='<mcp-http-token>' -- npx -y @dpesch/mantisbt-mcp-server. For Cursor, VS Code, Claude Desktop and Windsurf, use the install tabs above.

›Does MantisBT require an API key?

Yes. It expects MANTIS_BASE_URL, MANTIS_API_KEY, MCP_HTTP_TOKEN, of which 2 are secrets.

›Can I use MantisBT as a remote (hosted) MCP server?

No hosted endpoint is published; it runs locally over stdio.

›Is MantisBT in the official MCP registry?

Yes, as io.github.dpesch/mantisbt-mcp-server.