Web Search MCP Server

The Web Search MCP Server is an exclusive Remote MCP Server developed by Z.AI for GLM Coding Plan users. Built on the Model Context Protocol (MCP), it connects to search capabilities to provide web search and real-time information retrieval for MCP-compatible clients, including Claude Code and Cline.

Features

Web Search

Supports comprehensive web search to retrieve the latest web information and resources

Real-time Information

Retrieves real-time updated information including news, stock prices, weather, and more

Remote Service

HTTP protocol-based remote MCP service, no local installation required

Supported Tools

This server implements the Model Context Protocol and can be used with any MCP-compatible client. Currently provides the following tools:

• webSearchPrime - Search web information, returning results including page titles, URLs, summaries, site names, site icons, and more.

Installation and Usage

Quick Start

1. Get API Key

   Visit Z.AI Console to get your api key

2. Configure MCP Server

   According to the client you’re using, choose the corresponding installation method from the options below.

Supported Clients

Claude Code

One-click Installation Command

Be sure to replace your_api_key with the API Key you obtained.

claude mcp add -s user -t http web-search-prime https://api.z.ai/api/mcp/web_search_prime/mcp --header "Authorization: Bearer your_api_key"

Manual Configuration

Edit Claude Code’s configuration file .claude.json in the user directory, MCP section:

{
  "mcpServers": {
    "web-search-prime": {
      "type": "http",
      "url": "https://api.z.ai/api/mcp/web_search_prime/mcp",
      "headers": {
        "Authorization": "Bearer your_api_key"
      }
    }
  }
}

Cline (VS Code)

Add MCP server configuration in Cline extension settings:

Be sure to replace your_api_key with the API Key you obtained.

{
  "mcpServers": {
    "web-search-prime": {
      "type": "streamableHttp",
      "url": "https://api.z.ai/api/mcp/web_search_prime/mcp",
      "headers": {
        "Authorization": "Bearer your_api_key"
      }
    }
  }
}

If Cline older version does not support StreamableHttp type MCP server, you can use SSE type configuration:

{
  "mcpServers": {
    "web-search-prime": {
      "type": "sse",
      "url": "https://api.z.ai/api/mcp/web_search_prime/sse?Authorization=your_api_key"
    }
  }
}

OpenCode

Add MCP server configuration in OpenCode settings:

Refer OpenCode MCP Doc

Be sure to replace your_api_key with the API Key you obtained.

{
    "$schema": "https://opencode.ai/config.json",
    "mcp": {
        "web-search-prime": {
            "type": "remote",
            "url": "https://api.z.ai/api/mcp/web_search_prime/mcp",
            "headers": {
                "Authorization": "Bearer your_api_key"
            }
        }
    }
}

Crush

Add MCP server configuration in Crush settings:

Be sure to replace your_api_key with the API Key you obtained.

{
    "$schema": "https://charm.land/crush.json",
    "mcp": {
        "web-search-prime": {
            "type": "http",
            "url": "https://api.z.ai/api/mcp/web_search_prime/mcp",
            "headers": {
                "Authorization": "Bearer your_api_key"
            }
        }
    }
}

Goose

Not support Goose now，refer Issue

Add MCP server configuration in Goose settings:

Click Extensions -> Add custom extension

Set Extension Name is web-search-prime，Type switch HTTP，Endpoint as follow：

https://api.z.ai/api/mcp/web_search_prime/mcp

Set Request Headers Add Authorization : your_api_key

Finally, click Add Extension at the bottom. Remember to replace your_api_key with the API Key you obtained in the previous step.

Roo Code, Kilo Code and Other MCP Clients

For Roo Code, Kilo Code and other clients that support MCP protocol, use the following general configuration:

Be sure to replace your_api_key with the API Key you obtained.

{
  "mcpServers": {
    "web-search-prime": {
      "type": "streamable-http",
      "url": "https://api.z.ai/api/mcp/web_search_prime/mcp",
      "headers": {
        "Authorization": "Bearer your_api_key"
      }
    }
  }
}

Usage Example

Through the previous step of installing the Search MCP server to the client, you can directly use MCP in your Coding client.
You can directly use search functionality in conversations:

• “Help me search for the latest AI technology developments”
• “Find best practices for Python asynchronous programming”

Troubleshooting

Invalid API Key

Issue: Receiving invalid api key error

Solutions:

1. Confirm the api key is correctly copied
2. Check if the api key is activated
3. Confirm the api key has sufficient balance
4. Check if the Authorization header format is correct

Connection Timeout

Issue: MCP server connection timeout

Solutions:

1. Check network connection
2. Confirm firewall settings
3. Verify the server URL is correct
4. Increase timeout settings

Empty Search Results

Issue: Search returns empty results

Solutions:

1. Try using different search keywords
2. Check if the search query is too specific
3. Confirm network connection is normal
4. Contact technical support for assistance

Related Resources

• Model Context Protocol (MCP) Official Documentation
• Claude Code MCP Configuration Guide
• MCP Usage Limits
• GLM Coding Plan Overview