Skip to main content
Glama
MiniMax-AI

MiniMax Search MCP Server

Official
by MiniMax-AI

MiniMax Search MCP Server

English Doc | Chinese Doc

MiniMax Search is an MCP (Model Context Protocol) server that provides web search and browsing capabilities.

šŸ”§ Version Notes

This project uses the standard MCP Server protocol, compliant with MCP specifications:

  • āœ… Complete list_tools() implementation

  • āœ… Complete call_tool() implementation

  • āœ… Standard stdio_server() communication

Related MCP server: crawl-mcp

Features

  • šŸ” Multi-Engine Search: Supports Google search engine

  • šŸš€ Parallel Search: Native support for parallel multi-query search

  • 🌐 Batch Browsing: Support for batch browsing of multiple URLs

  • šŸ¤– Intelligent Understanding: Uses MiniMax LLM to understand web content and answer questions

  • šŸŽÆ Advanced Search: Supports Google advanced search syntax

  • šŸ”„ Auto Fallback: Automatically switches to other engines when search fails

Quick Start

# Run directly from Git repository
uvx --from git+ssh://git@github.com:MiniMax-AI/minimax_search.git minimax-search 

Install via Local Path (Development)

# Run from local directory
uvx --from /xxx/minimax_search minimax-search

MCP Client Configuration

Add to your MCP client configuration file (e.g., mcp.json):

{
  "mcpServers": {
    "minimax_search": {
      "command": "uvx",
      "args": [
        "--from",
        "git+ssh://git@github.com:MiniMax-AI/minimax_search.git",
        "minimax-search"
      ],
      "env": {
        "MINIMAX_API_KEY": "your_minimax_api_key",
        "SERPER_API_KEY": "your_serper_api_key",
        "JINA_API_KEY": "your_jina_api_key"
      }
    }
  }
}

Available Tools

Search multiple queries simultaneously, returning brief results (title, URL, snippet).

Parameters:

  • queries (array of strings, required): List of queries, supports Google advanced search syntax

Supported Search Engines:

  • Google Search (via Serper API)

Advanced Search Syntax:

  • site:example.com - Limit to specific site

  • intitle:keyword - Title contains keyword

  • inurl:keyword - URL contains keyword

  • "exact match" - Exact phrase match

Example:

{
  "queries": ["Python asyncio tutorial", "Python threading vs asyncio"]
}

2. browse - Batch Intelligent Browsing

Visit multiple web pages, use MiniMax LLM to understand content and answer questions.

Parameters:

  • urls (array of strings, required): List of target web page URLs

  • query (string, required): Question to be answered

Example:

{
  "urls": [
    "https://docs.python.org/3/library/asyncio.html",
    "https://realpython.com/async-io-python/"
  ],
  "query": "Summarize the main features and use cases of asyncio"
}

Environment Variables Configuration

Required Environment Variables

Basic Search Functionality:

Web Browsing Functionality:

  • JINA_API_KEY: Web content reading

Browse Functionality (LLM Understanding):

Usage Examples

Using in an Agent

Once the MCP server is started, the Agent can use the following tools:

Parallel search for multiple queries:

User: Search for "Python asyncio" and "Python threading" differences simultaneously

Agent: [Calls search tool]
→ search(queries=["Python asyncio", "Python threading"])
→ Returns search results for both queries (executed in parallel)

Batch browse multiple web pages:

User: Visit these links and summarize the main features of asyncio
     - https://docs.python.org/3/library/asyncio.html
     - https://realpython.com/async-io-python/

Agent: [Calls browse tool]
→ browse(
    urls=["https://docs.python.org/...", "https://realpython.com/..."],
    query="Summarize the main features of asyncio"
  )
→ Returns comprehensive summary and answer

Technical Implementation

Project Structure

minimax_search/
ā”œā”€ā”€ server.py                    # MCP Server entry point (2 tools)
ā”œā”€ā”€ minimax_search_browse.py     # Core search and browse implementation
ā”œā”€ā”€ pyproject.toml              # Project configuration
└── README.md

Core Features

Parallel Search:

  • Native support for queries array

  • Concurrent execution using thread pool

  • Automatic formatting and grouping of results

Batch Browsing:

  • Native support for urls array

  • Jina Reader extracts web content (converts to Markdown)

  • MiniMax LLM understands content and generates comprehensive answers

License

MIT

This project is based on the MiniMax-M2 Model project

Available Tools

2 tools
browseB

Explore specific information in a list of urls. The parameters are a url list and a query. The urls will be browsed, and each content will be sent to a Large Language Model (LLM) as the based information to answer the query.

ParametersJSON Schema
NameRequiredDescriptionDefault
urlsYesThe url list.
queryYesThe query. A detailed natural language query is recommended.

TDQS

B3.2/5.0
Behavior3/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

The description discloses that URLs are browsed and content is sent to an LLM to answer the query, which is a key behavioral trait. However, it lacks details on side effects, permissions, rate limits, or privacy implications, which are needed given no annotations.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is concise with two sentences that front-load the purpose and then explain the operation. No redundant or extraneous information is present.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness2/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

The description does not explain the output format or return value, nor does it address potential errors, timeouts, or limitations. Given the lack of an output schema, this is a significant omission for a tool that fetches URLs.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema coverage is 100%, and the description adds a recommendation for a detailed natural language query. However, the description largely restates the parameter names without adding significant new meaning beyond the schema.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose4/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description clearly states the tool explores specific information from a list of URLs using a query and an LLM. However, it does not explicitly differentiate the tool from its sibling 'search', which may lead to ambiguity.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines2/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

No guidance is provided on when to use this tool versus alternatives, nor any conditions or prerequisites. The description simply explains the tool's operation without contextual usage advice.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections. Dates show when Glama detected each change.

  1. 2 tool updatesv1.0.0
    • First observedbrowse
    • First observedsearch

TDQS

A3.8/5.0
Disambiguation5/5

The two tools have clearly distinct purposes: search finds web results, while browse extracts information from specific URLs. No overlap in functionality.

Naming Consistency5/5

Both tool names are single verbs ('browse', 'search') following a uniform imperative style. No mixed conventions or irregularities.

Tool Count5/5

With only 2 tools covering web search and targeted URL exploration, the count is minimal yet perfectly scoped for the server's purpose.

Completeness5/5

The server provides a complete surface for web search and browsing: search retrieves initial results, and browse extracts detailed information from selected URLs. No obvious gaps.

Maintenance

ActivityInactive
ResponsivenessUnresponsive

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Related MCP Connectors

Related MCP Servers

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/MiniMax-AI/minimax_search'

If you have feedback or need assistance with the MCP directory API, please join our Discord server