MantisBT MCP Server MCP Server

What the MantisBT MCP Server MCP server does

How models use it and what it is built for.

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

Connect to MantisBT MCP Server

Local install — runs as a subprocess.

Environment variables

Configuration this server reads at startup.

• MANTIS_BASE_URLRequired

  Base URL of the MantisBT REST API, e.g. https://your-mantis.example.com/api/rest

• MANTIS_API_KEYRequiredSecret

  MantisBT API key (Profile → API Tokens in MantisBT)

• 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_TOKENSecret

  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)

Resources

Where to find authoritative docs and source for MantisBT MCP Server.