SuperWebsearch MCP

SuperWebsearch MCP exposes one live web search tool backed by the 6551 SuperWebsearch API.

The public MCP package does not contain the upstream model gateway key. Users authenticate with a 6551 API token from https://www.newsliquid.com/mcp, the MCP server sends that token to the hosted backend, and the backend handles prompt assembly, rate limiting, and upstream model access.

Install

uv sync

Or install into another project:

uv pip install -e .

Authentication

Get a token at https://www.newsliquid.com/mcp and set:

export SUPERWEBSEARCH_TOKEN="<your-token>"

Optional settings:

export SUPERWEBSEARCH_API_BASE="https://ai.6551.io"
export SUPERWEBSEARCH_ENDPOINT="/open/websearch"

Claude Desktop / Claude Code

{
  "mcpServers": {
    "superwebsearch": {
      "command": "uv",
      "args": ["--directory", "/path/to/superwebsearch-mcp", "run", "superwebsearch-mcp"],
      "env": {
        "SUPERWEBSEARCH_TOKEN": "<your-token>"
      }
    }
  }
}

Tool

SuperWebsearch(query)

Parameters:

• query: full search, URL reading, fact-checking, source discovery, or research request.

Response:

The tool returns a JSON string from the backend. A successful response has:

{
  "ok": true,
  "answer": "...",
  "sources": ["https://..."],
  "meta": {
    "point_cost": 10,
    "elapsed_seconds": 12.3
  }
}

Rate Limit

Due to limited server resources, each API token can only be called once every 10 minutes.

Safety Review Checklist

This package:

• Connects only to the configured SUPERWEBSEARCH_API_BASE.
• Reads the 6551 token from SUPERWEBSEARCH_TOKEN or local config.json.
• Does not contain the upstream gateway API key.
• Does not execute shell commands, write user files, or read browser profiles.