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

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Maintenance

ActivityInactive
ResponsivenessNo issues

Resources

Related MCP Connectors

Related MCP Servers