Skip to main content
Glama
clint419

websearch-mcp-server

by clint419
OverviewSchemaSourceRelated ServersDiscussionsAdmin
TypeScript
Remote

websearch-mcp-server

Standalone MCP server for Exa/Parallel free web search + URL content fetching. Works with Cursor, Claude Code, Cline, Continue, opencode, and any MCP-compatible AI client.

Tools

Tool

Description

websearch

Search the web via Exa or Parallel free MCP endpoints

webfetch

Fetch content from an HTTP/HTTPS URL as text/markdown/html

Related MCP server: perplexity-mcp

Install

From npm (recommended)

npm install -g @clint419/websearch-mcp-server

From source

git clone https://github.com/clint419/websearch-mcp-server.git
cd websearch-mcp-server
npm install
npm run build

Configure

Cursor

Add to ~/.cursor/mcp.json:

{
  "mcpServers": {
    "websearch": {
      "command": "npx",
      "args": ["-y", "@clint419/websearch-mcp-server"]
    }
  }
}

Claude Code

Add to ~/.claude/mcp.json:

{
  "mcpServers": {
    "websearch": {
      "command": "npx",
      "args": ["-y", "@clint419/websearch-mcp-server"]
    }
  }
}

Cline / Continue

Same pattern. Add to their MCP config with the command above.

Local development

{
  "command": "npx",
  "args": ["tsx", "/path/to/websearch-mcp-server/src/index.ts"]
}

HTTP Streamable (remote / shared)

Start the HTTP server:

npx @clint419/websearch-mcp-server-http
# or: npm run start:http

Add to MCP config:

{
  "mcpServers": {
    "websearch": {
      "url": "http://127.0.0.1:3000/mcp",
      "transport": "streamable-http"
    }
  }
}

Environment Variables

Variable

Values

Default

Description

WEBSEARCH_PROVIDER

exa, parallel

exa

Which upstream to use

EXA_API_KEY

string

(none)

Optional Exa API key

PARALLEL_API_KEY

string

(none)

Optional Parallel API key

MCP_PORT

number

3000

HTTP Streamable listen port

MCP_HOST

string

127.0.0.1

HTTP Streamable bind address

Source Structure

src/
  index.ts      – stdio MCP entry point
  http.ts       – HTTP Streamable MCP entry point (stateful)
  server.ts     – shared MCP server: tool registration
  websearch.ts  – Exa/Parallel MCP client with retry + failover
  webfetch.ts   – URL content fetcher (HTML→text/markdown conversion)

Reliability

  • Retry: Up to 2 retries with exponential backoff (1s, 2s) on network errors

  • Failover: If primary provider fails, automatically tries the other provider

  • Timeout: 25s per request

  • Free tier: No API key required by default

License

MIT

This server cannot be deployed

RayrunBuild, deploy, and operate MCP servers without becoming an infrastructure team.ray.runAd

Maintenance

ActivityInactive
ResponsivenessNo issues

Resources

Related MCP Connectors

Related MCP Servers

  • Parallel Search MCP

    parallel-web
    A
    license
    Not graded
    quality
    B
    maintenance
    Free web search and page fetching for AI agents. No account or API key required. Connect to https://search.parallel.ai/mcp over Streamable HTTP. Tools: web_search and web_fetch. Free-tier rate limits apply.
    15
    MIT

  • perplexity-mcp

    fastmcp-me
    A
    license
    B
    quality
    D
    maintenance
    Enables web search using Perplexity AI's API, allowing users to search the web with optional recency filters and integration with Claude, Cursor, and other MCP clients.
    1
    MIT

  • exa-websets-mcp

    kabirrgrover
    F
    license
    Not graded
    quality
    D
    maintenance
    Unified gateway to Exa, Websets, and Deep Search for code search, deep research, and structured citations via any MCP client.
    -