Anysearch Mcp Server

AnySearch MCP Server

Unified real-time search MCP server supporting general web search, vertical domain search, parallel batch search, and full-page URL content extraction.

Features

• General Web Search — open-ended natural language queries
• Vertical Domain Search — structured queries across finance, academic, security, legal, code, and more
• Parallel Batch Search — execute multiple independent queries in one call
• URL Content Extraction — fetch and extract full page content as Markdown
• Anonymous Access — works without an API key (with lower rate limits)

API Key Configuration

An API key is optional but recommended. Without a key, all features still work via anonymous access with lower rate limits.

Get an API Key

Visit https://anysearch.com/console/api-keys to create a free API key.

Key Priority

| Priority | Source | |----------|--------| | 1 (highest) | --api_key CLI flag / Authorization header | | 2 | Environment variable ANYSEARCH_API_KEY | | 3 | .env file (ANYSEARCH_API_KEY=) | | 4 | Anonymous access (lower rate limits) |

Key Behavior

| Scenario | Behavior | |----------|----------| | No key | Proceed with anonymous access (lower rate limits) | | Has key | Sent via Authorization: Bearer header, higher rate limits | | Key exhausted, auto-registered key returned | Agent should ask user for confirmation, then persist the new key | | Key exhausted, no new key | Inform user and suggest configuring a new API key |

MCP Transport

AnySearch MCP server natively supports Streamable HTTP transport (MCP spec 2025-03-26). SSE and stdio clients can connect via proxy.

| Transport | Native? | Best for | |-----------|---------|----------| | Streamable HTTP | Yes | OpenCode, Claude Desktop (2025.6+), web-based clients | | SSE | Via proxy | Cursor, Windsurf | | stdio | Via proxy | Claude Desktop (legacy), VS Code Copilot, Cline |

Installation

Streamable HTTP (Recommended — No Proxy Needed)

For agents that support the Streamable HTTP transport (MCP spec 2025-03-26+):

OpenCode (~/.opencode/config.json or project opencode.json):

{
  "mcp": {
    "anysearch": {
      "type": "remote",
      "url": "https://api.anysearch.com/mcp",
      "headers": {
        "Authorization": "Bearer ${ANYSEARCH_API_KEY}"
      }
    }
  }
}

Claude Desktop (2025.6+, claude_desktop_config.json):

{
  "mcpServers": {
    "anysearch": {
      "type": "streamable-http",
      "url": "https://api.anysearch.com/mcp",
      "headers": {
        "Authorization": "Bearer ${ANYSEARCH_API_KEY}"
      }
    }
  }
}

> Without an API key, omit the headers section. The server will use anonymous access automatically.

stdio (Via Proxy)

For agents that only support stdio transport. Two proxy options:

Option A: mcp-remote (Recommended)

mcp-remote — auto-detects Streamable HTTP, simplest config:

Claude Desktop (claude_desktop_config.json):

{
  "mcpServers": {
    "anysearch": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://api.anysearch.com/mcp",
        "--header",
        "Authorization: Bearer ${ANYSEARCH_API_KEY}"
      ]
    }
  }
}

VS Code Copilot (.vscode/mcp.json):

{
  "servers": {
    "anysearch": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://api.anysearch.com/mcp",
        "--header",
        "Authorization: Bearer ${ANYSEARCH_API_KEY}"
      ]
    }
  }
}

Cline (VS Code settings):

{
  "mcpServers": {
    "anysearch": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://api.anysearch.com/mcp",
        "--header",
        "Authorization: Bearer ${ANYSEARCH_API_KEY}"
      ]
    }
  }
}

> Without an API key, omit the "--header" and "Authorization: Bearer ..." args.

Option B: supergateway

supergateway — more transport options, supports SSE output:

Claude Desktop (claude_desktop_config.json):

{
  "mcpServers": {
    "anysearch": {
      "command": "npx",
      "args": [
        "-y",
        "supergateway",
        "--streamableHttp",
        "https://api.anysearch.com/mcp",
        "--oauth2Bearer",
        "${ANYSEARCH_API_KEY}"
      ]
    }
  }
}

> Without an API key, omit the "--oauth2Bearer" and key args.

SSE (Via Proxy)

For agents that only support SSE transport (Cursor, Windsurf). Requires running a local SSE proxy server:

Start the proxy

npx -y supergateway \
  --streamableHttp https://api.anysearch.com/mcp \
  --outputTransport sse \
  --port 8000 \
  --oauth2Bearer 

> Without an API key, omit the --oauth2Bearer flag.

Then configure your agent:

Cursor (.cursor/mcp.json):

{
  "mcpServers": {
    "anysearch": {
      "type": "sse",
      "url": "http://localhost:8000/sse"
    }
  }
}

Windsurf (~/.codeium/windsurf/mcp_config.json):

{
  "mcpServers": {
    "anysearch": {
      "serverUrl": "http://localhost:8000/sse"
    }
  }
}

> The SSE proxy must remain running while the agent is active. Consider running it as a background service.

Agent Quick Reference

| Agent | Transport | Config Location | Needs Proxy? | Proxy Tool | |-------|-----------|----------------|-------------|------------| | OpenCode | Streamable HTTP | opencode.json | No | — | | Claude Desktop (2025.6+) | Streamable HTTP | claude_desktop_config.json | No | — | | Claude Desktop (legacy) | stdio | claude_desktop_config.json | Yes | mcp-remote | | Cursor | SSE | .cursor/mcp.json | Yes | supergateway | | VS Code Copilot | stdio | .vscode/mcp.json | Yes | mcp-remote | | Windsurf | SSE | mcp_config.json | Yes | supergateway | | Cline | stdio | VS Code settings | Yes | mcp-remote |

Available Tools

search

Execute a search query — general or vertical domain.

| Parameter | Type | Required | Description | |-----------|------|----------|-------------| | query | string | Yes | Natural language search query. ONE intent per call | | domain | string | No | Vertical domain (e.g. finance, academic, security). Must come from get_sub_domains enum | | sub_domain | string | No | Sub-domain routing key (e.g. finance.us_stock). Must come from get_sub_domains output | | sub_domain_params | object | No | Structured params from get_sub_domains params column. NEVER invent values | | max_results | integer | No | 1–10, default 10 |

get_sub_domains

Query the vertical domain directory. Required before any search that uses a domain — returns valid sub_domains and their parameter schemas.

| Parameter | Type | Required | Description | |-----------|------|----------|-------------| | domain | string | One of | Single domain to query | | domains | string[] | One of | Batch up to 5 domains (preferred — covers more ground) |

Returns a Markdown table: sub_domain | description | params

batch_search

Execute 1–5 independent search queries in parallel. Single failure does not block others.

| Parameter | Type | Required | Description | |-----------|------|----------|-------------| | queries | object[] | Yes | 1–5 query objects, each with same fields as search |

extract

Fetch full page content from a URL and return as Markdown. Truncated at 50,000 characters. HTML pages only.

| Parameter | Type | Required | Description | |-----------|------|----------|-------------| | url | string | Yes | Target URL (http:// or https://) |

Source & license

This open-source MCP server is cataloged on AgentStack and links to its original source — we do not rehost the code.

• Author: anysearch-ai
• Source: anysearch-ai/anysearch-mcp-server
• License: Apache-2.0
• Homepage: https://www.anysearch.com

Install and usage instructions live in the source repository linked above.