{"_id":"@clint419/websearch-mcp-server","_rev":"2-40ffc0d932ada1d784f1d9021e3f274d","name":"@clint419/websearch-mcp-server","dist-tags":{"latest":"1.0.1"},"versions":{"1.0.0":{"name":"@clint419/websearch-mcp-server","version":"1.0.0","keywords":["mcp","websearch","exa","parallel","ai","search"],"license":"MIT","_id":"@clint419/websearch-mcp-server@1.0.0","maintainers":[{"name":"clint419","email":"syl416419@gmail.com"}],"bin":{"websearch-mcp":"dist/server.js"},"dist":{"shasum":"4a57d570c988e7733826a8385290924b3a381afb","tarball":"https://registry.npmjs.org/@clint419/websearch-mcp-server/-/websearch-mcp-server-1.0.0.tgz","fileCount":6,"integrity":"sha512-w6+NAspDHK2Llx1OOjIOadzRcCmpGou9B2f1AvSEMIJdSM0KW0vMzQ3Rh5eBmxmktk2U08hDLqAiL6x1+QXU9Q==","signatures":[{"sig":"MEYCIQDvZKqFqDFzXCPZp9ARvLS5dOQv21c2+2q4pazOuKqMHQIhAKaUr3ICyN2Jejvs2uzwMNIvJWp9jhJFaGLb3bxPpC/o","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":17910},"main":"dist/server.js","type":"module","types":"./dist/server.d.ts","engines":{"node":">=18.0.0"},"gitHead":"03b4fac982e2461a57f288f0060b3d89bf6968b2","scripts":{"dev":"tsc --watch","build":"tsc","start":"node dist/server.js","prepublishOnly":"npm run build"},"_npmUser":{"name":"clint419","email":"syl416419@gmail.com"},"_npmVersion":"11.12.1","description":"Standalone MCP server for Exa/Parallel free web search","directories":{},"_nodeVersion":"24.15.0","dependencies":{"@modelcontextprotocol/sdk":"^1.29.0"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"tsx":"^4.0.0","typescript":"^5.7.0","@types/node":"^22.0.0"},"_npmOperationalInternal":{"tmp":"tmp/websearch-mcp-server_1.0.0_1781422430658_0.8604585894563259","host":"s3://npm-registry-packages-npm-production"}},"1.0.1":{"name":"@clint419/websearch-mcp-server","version":"1.0.1","description":"Standalone MCP server for Exa/Parallel free web search","type":"module","main":"dist/server.js","bin":{"websearch-mcp":"dist/server.js"},"scripts":{"build":"tsc","dev":"tsc --watch","start":"node dist/server.js","prepublishOnly":"npm run build"},"keywords":["mcp","websearch","exa","parallel","ai","search"],"dependencies":{"@modelcontextprotocol/sdk":"^1.29.0"},"devDependencies":{"@types/node":"^22.0.0","tsx":"^4.0.0","typescript":"^5.7.0"},"engines":{"node":">=18.0.0"},"license":"MIT","publishConfig":{"access":"public"},"gitHead":"9ba528a73ee507b0af2209baff5465dd47ed2d2d","types":"./dist/server.d.ts","_id":"@clint419/websearch-mcp-server@1.0.1","_nodeVersion":"24.15.0","_npmVersion":"11.12.1","dist":{"integrity":"sha512-l9pWk+fx6BDUwKuyIAepGjBNd1PSsy5Cuz7U8Cw1mB6wNFl+ICksygH8LyygYbIbQSlkVXobwzUekSKwJ+BtXA==","shasum":"a19f70a0477b3bd37e8839483d84758ae1b26a9f","tarball":"https://registry.npmjs.org/@clint419/websearch-mcp-server/-/websearch-mcp-server-1.0.1.tgz","fileCount":6,"unpackedSize":17820,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEQCICou6Jx+W7uoJwwJI7LxIain5I6Aplep0mPiT5Bx6F0XAiBdO2zVHaMeLIttZ2yT0P576dgNxvf2oIFY7kClmuQPZg=="}]},"_npmUser":{"name":"clint419","email":"syl416419@gmail.com"},"directories":{},"maintainers":[{"name":"clint419","email":"syl416419@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/websearch-mcp-server_1.0.1_1781423191190_0.5465538229033318"},"_hasShrinkwrap":false}},"time":{"created":"2026-06-14T07:33:50.529Z","modified":"2026-06-14T07:46:31.445Z","1.0.0":"2026-06-14T07:33:50.785Z","1.0.1":"2026-06-14T07:46:31.335Z"},"license":"MIT","keywords":["mcp","websearch","exa","parallel","ai","search"],"description":"Standalone MCP server for Exa/Parallel free web search","maintainers":[{"name":"clint419","email":"syl416419@gmail.com"}],"readme":"# websearch-mcp-server\n\nStandalone MCP server for Exa/Parallel free web search. Works with Cursor, Claude Code, Cline, Continue, opencode, and any MCP-compatible AI client.\n\n## Install\n\n### From npm (recommended)\n\n```bash\nnpm install -g @clint419/websearch-mcp-server\n```\n\n### From source\n\n```bash\ngit clone https://github.com/clint419/websearch-mcp-server.git\ncd websearch-mcp-server\nnpm install\nnpm run build\n```\n\n## Configure\n\n### Cursor\n\nAdd to `~/.cursor/mcp.json`:\n\n```json\n{\n  \"mcpServers\": {\n    \"websearch\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@clint419/websearch-mcp-server\"]\n    }\n  }\n}\n```\n\n### Claude Code\n\nAdd to `~/.claude/mcp.json`:\n\n```json\n{\n  \"mcpServers\": {\n    \"websearch\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@clint419/websearch-mcp-server\"]\n    }\n  }\n}\n```\n\n### Cline / Continue\n\nSame pattern. Add to their MCP config with the command above.\n\n### Local development\n\nIf running from source instead of npm:\n\n```json\n{\n  \"command\": \"npx\",\n  \"args\": [\"tsx\", \"/path/to/websearch-mcp-server/src/server.ts\"]\n}\n```\n\n## Environment Variables\n\n| Variable | Values | Default | Description |\n|----------|--------|---------|-------------|\n| `WEBSEARCH_PROVIDER` | `exa`, `parallel` | `exa` | Which upstream to use |\n| `EXA_API_KEY` | string | (none) | Optional Exa API key |\n| `PARALLEL_API_KEY` | string | (none) | Optional Parallel API key |\n\n## Tool\n\n**`websearch`** - Search the web\n\n| Parameter | Type | Required | Default | Description |\n|-----------|------|----------|---------|-------------|\n| `query` | string | yes | - | Search query |\n| `numResults` | number | no | 8 | Number of results (max: 20) |\n| `type` | string | no | `auto` | `auto`, `fast`, `deep` |\n| `livecrawl` | string | no | `fallback` | `fallback`, `preferred` |\n| `contextMaxCharacters` | number | no | 10000 | Max context chars for LLM |\n\n## How It Works\n\n```\nAI Client (Cursor/Claude Code/etc.)\n    ↓ stdio JSON-RPC\n[websearch-mcp-server]\n    ↓ retry + failover\n    ↓ HTTP POST JSON-RPC 2.0\nExa / Parallel remote MCP endpoint\n    ↓ results\n[websearch-mcp-server] → AI Client\n```\n\n### Reliability\n\n- **Retry**: Up to 2 retries with exponential backoff (1s, 2s) on network errors\n- **Failover**: If primary provider fails, automatically tries the other provider\n- **Timeout**: 25s per request\n- **Free tier**: No API key required by default\n\n## License\n\nMIT\n","readmeFilename":"README.md"}