Best for
- Developers who need intent-based search
- Teams using coding agents
- Users who want multi-format search from a terminal
M
36FMRS · D
The source material describes Mixedbread's CLI semantic-search tool, not a confirmed MCP server. No server manifest, MCP tools, transport protocol, or client compatibility evidence is provided.
mgrep is a command-line tool for semantic, natural-language search across code, text, PDFs, and images, with optional web search. It indexes files into a Mixedbread Store and supports continuous syncing, reranking, and agentic search for complex questions.
Tools
The tool list has not been reviewed yet.
Setup
Install @mixedbread/mgrep globally with npm, pnpm, or bun. Run mgrep login to authenticate, or set MXBAI_API_KEY for CI/CD and headless environments. Enter a project directory and run mgrep watch to create and continuously update its index.
Fit and risk
Not for
- Workflows requiring only exact matches, regular expressions, or symbol tracing
- Clients requiring a confirmed MCP tool or transport integration
- Environments where files must not be uploaded to a cloud service
Required permissions
- Read project files and sync them according to .gitignore and .mgrepignore
- Upload eligible files to a Mixedbread Store
- Authenticate through browser login or MXBAI_API_KEY
- Monitor file changes continuously when watch mode is active
Risks and side effects
- Files are synchronized to a cloud-hosted Mixedbread Store
- The default limits are 1MB per file and 1,000 files per directory, though configuration can change them
- Background synchronization may continue during agent sessions and contribute to platform usage
- Web search and generated answers may include external information that requires verification
Troubleshooting
- If login repeatedly reopens, run mgrep logout and authenticate again
- Check that MXBAI_API_KEY is set correctly
- Review .gitignore, .mgrepignore, file-size, and file-count limits
- Use --store or MXBAI_STORE to isolate workspaces
- For a fresh index, delete the old Store in the Mixedbread dashboard and run mgrep watch again
Use cases
Exploring codebases with natural-language queries
Searching local PDFs, text, and images
Combining local-file and web search
Providing semantic retrieval for coding agents
Supported clients
Supported clients have not been confirmed yet.