English Français العربية

MantisBT MCP Server

Official registry Search and web

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

Install

Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).

NPM package @dpesch/mantisbt-mcp-server
Claude Code 
claude mcp add mantisbt-mcp-server -e 'MANTIS_BASE_URL=<MANTIS_BASE_URL>' -e 'MANTIS_API_KEY=<your mantis_api_key>' -e 'MANTIS_USE_INDEX_PHP=false' -e 'MANTIS_CACHE_DIR=<MANTIS_CACHE_DIR>' -e 'MANTIS_CACHE_TTL=3600' -e 'TRANSPORT=stdio' -e 'PORT=3000' -e 'MCP_HTTP_HOST=127.0.0.1' -e 'MCP_HTTP_TOKEN=<your mcp_http_token>' -e 'MANTIS_SEARCH_ENABLED=false' -e 'MANTIS_SEARCH_BACKEND=vectra' -e 'MANTIS_SEARCH_DIR=<MANTIS_SEARCH_DIR>' -e 'MANTIS_SEARCH_MODEL=Xenova/paraphrase-multilingual-MiniLM-L12-v2' -e 'MANTIS_SEARCH_THREADS=1' -e 'MANTIS_UPLOAD_DIR=<MANTIS_UPLOAD_DIR>' -- npx -y @dpesch/mantisbt-mcp-server@1.15.0
JSON configuration (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "mantisbt-mcp-server": {
            "command": "npx",
            "args": [
                "-y",
                "@dpesch/mantisbt-mcp-server@1.15.0"
            ],
            "env": {
                "MANTIS_BASE_URL": "<MANTIS_BASE_URL>",
                "MANTIS_API_KEY": "<your mantis_api_key>",
                "MANTIS_USE_INDEX_PHP": "false",
                "MANTIS_CACHE_DIR": "<MANTIS_CACHE_DIR>",
                "MANTIS_CACHE_TTL": "3600",
                "TRANSPORT": "stdio",
                "PORT": "3000",
                "MCP_HTTP_HOST": "127.0.0.1",
                "MCP_HTTP_TOKEN": "<your mcp_http_token>",
                "MANTIS_SEARCH_ENABLED": "false",
                "MANTIS_SEARCH_BACKEND": "vectra",
                "MANTIS_SEARCH_DIR": "<MANTIS_SEARCH_DIR>",
                "MANTIS_SEARCH_MODEL": "Xenova/paraphrase-multilingual-MiniLM-L12-v2",
                "MANTIS_SEARCH_THREADS": "1",
                "MANTIS_UPLOAD_DIR": "<MANTIS_UPLOAD_DIR>"
            }
        }
    }
}

Environment variables

  • MANTIS_BASE_URL required Base URL of the MantisBT REST API, e.g. https://your-mantis.example.com/api/rest
  • MANTIS_API_KEY required secret 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 secret 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)

Frequently asked questions

What is MantisBT MCP Server?

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

How do I install MantisBT MCP Server?

It runs on your machine. In Claude Code: claude mcp add mantisbt-mcp-server -e 'MANTIS_BASE_URL=<MANTIS_BASE_URL>' -e 'MANTIS_API_KEY=<your mantis_api_key>' -e 'MANTIS_USE_INDEX_PHP=false' -e 'MANTIS_CACHE_DIR=<MANTIS_CACHE_DIR>' -e 'MANTIS_CACHE_TTL=3600' -e 'TRANSPORT=stdio' -e 'PORT=3000' -e 'MCP_HTTP_HOST=127.0.0.1' -e 'MCP_HTTP_TOKEN=<your mcp_http_token>' -e 'MANTIS_SEARCH_ENABLED=false' -e 'MANTIS_SEARCH_BACKEND=vectra' -e 'MANTIS_SEARCH_DIR=<MANTIS_SEARCH_DIR>' -e 'MANTIS_SEARCH_MODEL=Xenova/paraphrase-multilingual-MiniLM-L12-v2' -e 'MANTIS_SEARCH_THREADS=1' -e 'MANTIS_UPLOAD_DIR=<MANTIS_UPLOAD_DIR>' -- npx -y @dpesch/mantisbt-mcp-server@1.15.0. For other clients, paste the JSON configuration from this page into their MCP settings.

Does MantisBT MCP Server need an API key?

Yes. It expects MANTIS_BASE_URL, MANTIS_API_KEY, MCP_HTTP_TOKEN, which you set in its configuration.

Who maintains MantisBT MCP Server?

It is published by dpesch. AI.tn lists it but does not maintain or endorse it.

From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.