MantisBT MCP Server

io.github.dpesch/mantisbt-mcp-server · v1.18.4

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

Set it up

Connect Runs on your machine

Terminal

claude mcp add mantisbt-mcp-server -e MANTIS_BASE_URL=<MANTIS_BASE_URL> -e MANTIS_API_KEY=<MANTIS_API_KEY> -e MANTIS_USE_INDEX_PHP=<MANTIS_USE_INDEX_PHP> -e MANTIS_CACHE_DIR=<MANTIS_CACHE_DIR> -e MANTIS_CACHE_TTL=<MANTIS_CACHE_TTL> -e TRANSPORT=<TRANSPORT> -e PORT=<PORT> -e MCP_HTTP_HOST=<MCP_HTTP_HOST> -e MCP_HTTP_TOKEN=<MCP_HTTP_TOKEN> -e MCP_HTTP_MAX_BODY_SIZE=<MCP_HTTP_MAX_BODY_SIZE> -e MANTIS_SEARCH_ENABLED=<MANTIS_SEARCH_ENABLED> -e MANTIS_SEARCH_BACKEND=<MANTIS_SEARCH_BACKEND> -e MANTIS_SEARCH_DIR=<MANTIS_SEARCH_DIR> -e MANTIS_SEARCH_MODEL=<MANTIS_SEARCH_MODEL> -e MANTIS_SEARCH_THREADS=<MANTIS_SEARCH_THREADS> -e MANTIS_UPLOAD_DIR=<MANTIS_UPLOAD_DIR> -- npx -y @dpesch/[email protected]

claude_desktop_config.json

{
  "mcpServers": {
    "mantisbt-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "@dpesch/[email protected]"
      ],
      "env": {
        "MANTIS_BASE_URL": "<MANTIS_BASE_URL>",
        "MANTIS_API_KEY": "<MANTIS_API_KEY>",
        "MANTIS_USE_INDEX_PHP": "<MANTIS_USE_INDEX_PHP>",
        "MANTIS_CACHE_DIR": "<MANTIS_CACHE_DIR>",
        "MANTIS_CACHE_TTL": "<MANTIS_CACHE_TTL>",
        "TRANSPORT": "<TRANSPORT>",
        "PORT": "<PORT>",
        "MCP_HTTP_HOST": "<MCP_HTTP_HOST>",
        "MCP_HTTP_TOKEN": "<MCP_HTTP_TOKEN>",
        "MCP_HTTP_MAX_BODY_SIZE": "<MCP_HTTP_MAX_BODY_SIZE>",
        "MANTIS_SEARCH_ENABLED": "<MANTIS_SEARCH_ENABLED>",
        "MANTIS_SEARCH_BACKEND": "<MANTIS_SEARCH_BACKEND>",
        "MANTIS_SEARCH_DIR": "<MANTIS_SEARCH_DIR>",
        "MANTIS_SEARCH_MODEL": "<MANTIS_SEARCH_MODEL>",
        "MANTIS_SEARCH_THREADS": "<MANTIS_SEARCH_THREADS>",
        "MANTIS_UPLOAD_DIR": "<MANTIS_UPLOAD_DIR>"
      }
    }
  }
}

~/.cursor/mcp.json

{
  "mcpServers": {
    "mantisbt-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "@dpesch/[email protected]"
      ],
      "env": {
        "MANTIS_BASE_URL": "<MANTIS_BASE_URL>",
        "MANTIS_API_KEY": "<MANTIS_API_KEY>",
        "MANTIS_USE_INDEX_PHP": "<MANTIS_USE_INDEX_PHP>",
        "MANTIS_CACHE_DIR": "<MANTIS_CACHE_DIR>",
        "MANTIS_CACHE_TTL": "<MANTIS_CACHE_TTL>",
        "TRANSPORT": "<TRANSPORT>",
        "PORT": "<PORT>",
        "MCP_HTTP_HOST": "<MCP_HTTP_HOST>",
        "MCP_HTTP_TOKEN": "<MCP_HTTP_TOKEN>",
        "MCP_HTTP_MAX_BODY_SIZE": "<MCP_HTTP_MAX_BODY_SIZE>",
        "MANTIS_SEARCH_ENABLED": "<MANTIS_SEARCH_ENABLED>",
        "MANTIS_SEARCH_BACKEND": "<MANTIS_SEARCH_BACKEND>",
        "MANTIS_SEARCH_DIR": "<MANTIS_SEARCH_DIR>",
        "MANTIS_SEARCH_MODEL": "<MANTIS_SEARCH_MODEL>",
        "MANTIS_SEARCH_THREADS": "<MANTIS_SEARCH_THREADS>",
        "MANTIS_UPLOAD_DIR": "<MANTIS_UPLOAD_DIR>"
      }
    }
  }
}

.vscode/mcp.json

{
  "servers": {
    "mantisbt-mcp-server": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@dpesch/[email protected]"
      ],
      "env": {
        "MANTIS_BASE_URL": "<MANTIS_BASE_URL>",
        "MANTIS_API_KEY": "<MANTIS_API_KEY>",
        "MANTIS_USE_INDEX_PHP": "<MANTIS_USE_INDEX_PHP>",
        "MANTIS_CACHE_DIR": "<MANTIS_CACHE_DIR>",
        "MANTIS_CACHE_TTL": "<MANTIS_CACHE_TTL>",
        "TRANSPORT": "<TRANSPORT>",
        "PORT": "<PORT>",
        "MCP_HTTP_HOST": "<MCP_HTTP_HOST>",
        "MCP_HTTP_TOKEN": "<MCP_HTTP_TOKEN>",
        "MCP_HTTP_MAX_BODY_SIZE": "<MCP_HTTP_MAX_BODY_SIZE>",
        "MANTIS_SEARCH_ENABLED": "<MANTIS_SEARCH_ENABLED>",
        "MANTIS_SEARCH_BACKEND": "<MANTIS_SEARCH_BACKEND>",
        "MANTIS_SEARCH_DIR": "<MANTIS_SEARCH_DIR>",
        "MANTIS_SEARCH_MODEL": "<MANTIS_SEARCH_MODEL>",
        "MANTIS_SEARCH_THREADS": "<MANTIS_SEARCH_THREADS>",
        "MANTIS_UPLOAD_DIR": "<MANTIS_UPLOAD_DIR>"
      }
    }
  }
}

Replace the values in angle brackets with your own. Keys stay on your machine; we never see them.

Tools

This server runs locally, so its tools are listed by your MCP client once it starts.

Environment variables

Name	Description
`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` Optional	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` Optional	Directory for the metadata cache. Defaults to ~/.cache/mantisbt-mcp; each base URL and API key gets its own subdirectory
`MANTIS_CACHE_TTL` Optional	Metadata cache TTL in seconds. Default: 3600 (1 hour)
`TRANSPORT` Optional	Transport mode. 'stdio' for local use (default), 'http' for remote/team deployments
`PORT` Optional	HTTP port when TRANSPORT=http. Default: 3000
`MCP_HTTP_HOST` Optional	Bind address when TRANSPORT=http. Default: 127.0.0.1 (local only). Use 0.0.0.0 for Docker/remote.
`MCP_HTTP_TOKEN` Optional, secret	Bearer token protecting the /mcp endpoint. Required when TRANSPORT=http; the server refuses to start without it
`MCP_HTTP_MAX_BODY_SIZE` Optional	Largest accepted /mcp request body in bytes when TRANSPORT=http. Default: 67108864 (64 MB)
`MANTIS_SEARCH_ENABLED` Optional	Enable offline semantic search (requires ~80 MB model download on first use)
`MANTIS_SEARCH_BACKEND` Optional	Vector store backend for semantic search. 'vectra' (default, pure JS) or 'sqlite-vec' (faster for >10k issues)
`MANTIS_SEARCH_DIR` Optional	Directory for the semantic search index. Defaults to the search subdirectory of the instance cache directory; when set, each base URL and API key gets its own subdirectory
`MANTIS_SEARCH_MODEL` Optional	Hugging Face model for embeddings. Default: Xenova/paraphrase-multilingual-MiniLM-L12-v2
`MANTIS_SEARCH_THREADS` Optional	ONNX inference threads for the embedding model. Default: 1
`MANTIS_UPLOAD_DIR` Optional	If set, restricts file uploads to this directory (path traversal protection)

Details

Package	`@dpesch/[email protected]` (NPM, stdio)
First published	13 Nov 2026
Last updated	13 Nov 2026
Registry name	`io.github.dpesch/mantisbt-mcp-server`

More search and web servers See all

Live status

Local install

Installed and run on your own machine, so there is no public endpoint to check.

Pair it with live search

Agents that use MantisBT MCP Server often also need current facts. NestDaddy MCP gives your AI today's internet: web search, real-time breaking news and full page reading in one connector.

See NestDaddy MCP

For maintainers

[![NestDaddy MCP](https://nestdaddy.com/mcp/servers/io-github-dpesch-mantisbt-mcp-server/badge.svg)](https://nestdaddy.com/mcp/servers/io-github-dpesch-mantisbt-mcp-server)

Add the badge to your README. It turns green while your server passes our daily check. Listing details come from the official MCP registry; update them there.

Listing data from the official MCP registry. Status and tools from NestDaddy's daily check. Browse all MCP servers.