> ## Documentation Index
> Fetch the complete documentation index at: https://platform.minimax.io/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Web search MCP

> Add web search to AI tools through MCP.

Web search MCP provides the `web_search` tool, helping AI tools access information on the web during coding.

## Tool Description

<AccordionGroup>
  <Accordion title="web_search" icon="search">
    Performs web searches based on search queries, returning search results and related suggestions.

    | Parameter | Type | Required | Description |
    | :- | :- | :-: | :- |
    | query | string | ✓ | Search query |
  </Accordion>
</AccordionGroup>

## Prerequisites

<Steps>
  <Step title="Get API Key">
    Use your Subscription Key.
  </Step>

  <Step title="Install uvx">
    <CodeGroup>
      ```bash macOS / Linux theme={null}
      curl -LsSf https://astral.sh/uv/install.sh | sh
      ```

      ```powershell Windows theme={null}
      powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"
      ```
    </CodeGroup>

    <Note>
      For other installation methods, refer to the [uv repository](https://github.com/astral-sh/uv).
    </Note>
  </Step>

  <Step title="Verify Installation">
    <CodeGroup>
      ```bash macOS / Linux theme={null}
      which uvx
      ```

      ```powershell Windows theme={null}
      (Get-Command uvx).source
      ```
    </CodeGroup>

    <Note>
      If installed correctly, a path will be shown (e.g., `/usr/local/bin/uvx`). If you get `spawn uvx ENOENT` error, you need to configure the absolute path.
    </Note>
  </Step>
</Steps>

## Use in Claude Code

<Steps>
  <Step title="Download Claude Code">
    Download and install Claude Code from [Claude Code official website](https://www.claude.com/product/claude-code)
  </Step>

  <Step title="Configure MCP">
    <Tabs>
      <Tab title="Quick Install">
        Run the following command in terminal, replace `api_key` with your API Key:

        ```bash theme={null}
        claude mcp add -s user MiniMax --env MINIMAX_API_KEY=api_key --env MINIMAX_API_HOST=https://api.minimax.io -- uvx minimax-coding-plan-mcp
        ```
      </Tab>

      <Tab title="Manual Configuration">
        Edit the config file `~/.claude.json`, add the following MCP configuration:

        ```json theme={null}
        {
          "mcpServers": {
            "MiniMax": {
              "command": "uvx",
              "args": ["minimax-coding-plan-mcp"],
              "env": {
                "MINIMAX_API_KEY": "MINIMAX_API_KEY",
                "MINIMAX_API_HOST": "https://api.minimax.io"
              }
            }
          }
        }
        ```
      </Tab>
    </Tabs>
  </Step>

  <Step title="Verify Configuration">
    After entering Claude Code, type `/mcp`. If you can see `web_search`, the configuration is successful.

    <img src="https://filecdn.minimax.chat/public/59a2ac4d-fe8a-42d9-8898-e81aea641622.png" width="80%" />
  </Step>
</Steps>

## Use in Cursor

<Steps>
  <Step title="Download Cursor">
    Download and install Cursor from [Cursor official website](https://cursor.com/)
  </Step>

  <Step title="Open MCP Configuration">
    Open `Customize -> MCPs`, then click `New` to create an MCP server.

    ![Create an MCP server in Cursor](https://file.cdn.minimax.io/public/agent-tool/mcp/cursor-entry/20260904-143832.png)
  </Step>

  <Step title="Add Configuration">
    Add the following configuration to `mcp.json` file:

    ```json theme={null}
    {
      "mcpServers": {
        "MiniMax": {
          "command": "uvx",
          "args": ["minimax-coding-plan-mcp"],
          "env": {
            "MINIMAX_API_KEY": "Enter your API Key",
            "MINIMAX_API_HOST": "https://api.minimax.io"
          }
        }
      }
    }
    ```
  </Step>
</Steps>

## Use in OpenCode

<Steps>
  <Step title="Download OpenCode">
    Download and install OpenCode from [OpenCode official website](https://opencode.ai/)
  </Step>

  <Step title="Configure MCP">
    Edit the config file `~/.config/opencode/opencode.json`, add the following MCP configuration:

    ```json theme={null}
    {
      "$schema": "https://opencode.ai/config.json",
      "mcp": {
        "MiniMax": {
          "type": "local",
          "command": ["uvx", "minimax-coding-plan-mcp"],
          "environment": {
            "MINIMAX_API_KEY": "MINIMAX_API_KEY",
            "MINIMAX_API_HOST": "https://api.minimax.io"
          },
          "enabled": true
        }
      }
    }
    ```
  </Step>

  <Step title="Verify Configuration">
    After entering OpenCode, type `/mcp`. If you can see `MiniMax connected`, the configuration is successful.

    <img src="https://filecdn.minimax.chat/public/1a24c300-4cff-40ee-a428-869467074c1d.png" width="80%" />
  </Step>
</Steps>
