Web Reader MCP Server - Overview - Z.AI DEVELOPER DOCUMENT

The Web Reader 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 webpage content extraction capabilities to provide webpage content extraction, detailed page reading, and structured data retrieval for MCP-compatible clients, including Claude Code and Cline.

Features

Web Content Reading

Fetch the complete content of any webpage, including text, and links

Structured Data

Extract structured data such as title, main body, and metadata

Remote Service

HTTP-based remote MCP service, no local installation required

Tools

This server implements the Model Context Protocol and works with any MCP-compatible client. Currently, it provides the following tool:

webReader — Fetch webpage content for a specified URL. Returns the page title, main content, metadata, list of links, and more.

Example Scenarios

API Documentation Reading and Summarization

Automatically fetch and parse titles, body content, examples, and release notes from official documentation pages, distilling key takeaways to accelerate integration and implementation.

Open Source Project Page Parsing

Parse project websites or repository pages (such as README, release notes, and usage guides) to extract core information and link lists, assisting evaluation and integration.

Technical Article Understanding and Knowledge Extraction

Extract steps, commands, and caveats from blogs, tutorials, and guide pages, organizing unstructured content into actionable developer notes and task lists.

Bug Resolution Using Reference Documentation

For issue remediation, read the publicly available steps on the specified web page and use them as references to resolve the problem.

Knowledge Base Construction and Synchronization

Convert content from designated web pages into structured data and leverage in-page links for incremental synchronization to build a team technical knowledge base.

Installation and Usage

Quick Start

Get API Key

Visit Z.AI Console to get your api key

Configure MCP Server

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

Supported Clients

One-click install commandReplace your_api_key with the API key you obtained in the previous step

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

Manual configurationEdit the Claude Code configuration file under your home directory, the MCP section of .claude.json:

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

Add the MCP server configuration in the Cline extension settings:Replace your_api_key with the API key you obtained in the previous step

{
  "mcpServers": {
    "web-reader": {
      "type": "streamableHttp",
      "url": "https://api.z.ai/api/mcp/web_reader/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-reader": {
      "type": "sse",
      "url": "https://api.z.ai/api/mcp/web_reader/sse?Authorization=your_api_key"
    }
  }
}

Add the MCP server configuration in OpenCode settings:See the OpenCode MCP documentationReplace your_api_key with the API key you obtained in the previous step

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

Add the MCP server configuration in Crush settings:Replace your_api_key with the API key you obtained in the previous step

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

Not support Goose now，refer IssueAdd the MCP server in Goose:Go to Extensions -> Add custom extensionSet Extension Name to web-reader, Type to HTTP, and use the following endpoint:

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

Set Request Headers Add Authorization : your_api_keyClick Add Extension at the bottom. Remember to replace your_api_key with the API key you obtained in the previous step.

For Roo Code, Kilo Code, and other MCP-compatible clients, use the following general configuration:Replace your_api_key with the API key you obtained in the previous step

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

Troubleshooting

Invalid access token

Issue: Received an invalid access token errorSolutions:

Verify the token was copied correctly
Check that the token is activated
Ensure the token has sufficient balance
Confirm the Authorization header format is correct

Connection timeout

Issue: Connection to the MCP server timed outSolutions:

Check your network connection
Verify firewall settings
Ensure the server URL is correct
Increase client timeout settings

Webpage fetch failed

Issue: Web content reading returned empty result or errorSolutions:

Confirm the target URL is accessible
Check if the page has anti-scraping mechanisms
Try different URLs
Ensure network connectivity is normal
Contact technical support for assistance

​Features

Web Content Reading

Structured Data

Remote Service

​Tools

​Example Scenarios

​Installation and Usage

​Quick Start

​Supported Clients

​Troubleshooting

​Resources