{"_id":"synthetic-web-search-mcp","_rev":"6-687cbff6c8651c3e4e87cb6632c5addc","name":"synthetic-web-search-mcp","dist-tags":{"latest":"0.1.5"},"versions":{"0.1.0":{"name":"synthetic-web-search-mcp","version":"0.1.0","keywords":["mcp","model-context-protocol","web-search","synthetic","search","api"],"author":"parnexcodes","license":"MIT","_id":"synthetic-web-search-mcp@0.1.0","maintainers":[{"name":"parnexcodes","email":"parnexcodes@gmail.com"}],"homepage":"https://github.com/parnexcodes/synthetic-web-search-mcp#readme","bugs":{"url":"https://github.com/parnexcodes/synthetic-web-search-mcp/issues"},"bin":{"synthetic-web-search-mcp":"dist/index.js"},"dist":{"shasum":"2ddfeff05e44dea7259854cea5efcafdd1bab8e6","tarball":"https://registry.npmjs.org/synthetic-web-search-mcp/-/synthetic-web-search-mcp-0.1.0.tgz","fileCount":7,"integrity":"sha512-rIa+vi1vOWiB8GS7GO3MeeiYMvfZjxLBY1hxnfw8lVYsXYP/ipt+4SPf1HA0d05sdZaBMUCS6E81SZn15kjVaA==","signatures":[{"sig":"MEUCIQCmxhz5KjXR39QEr2NkdLe1uryRJI/rJAwUtvAbzTu9NgIgcLJ1OAZ+aMgxAoFkFTD+/+Sdt5652BHORZIDI5eQXz0=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":10339},"main":"dist/index.js","type":"module","shasum":"2ddfeff05e44dea7259854cea5efcafdd1bab8e6","scripts":{"dev":"node --loader ts-node/esm src/index.ts","build":"tsc","start":"node dist/index.js","watch":"tsc --watch","prepublishOnly":"npm run build"},"_npmUser":{"name":"parnexcodes","email":"parnexcodes@gmail.com"},"_integrity":"sha512-rIa+vi1vOWiB8GS7GO3MeeiYMvfZjxLBY1hxnfw8lVYsXYP/ipt+4SPf1HA0d05sdZaBMUCS6E81SZn15kjVaA==","repository":{"url":"git+https://github.com/parnexcodes/synthetic-web-search-mcp.git","type":"git"},"_npmVersion":"10.8.3","description":"MCP server for Synthetic Web Search API","directories":{},"_nodeVersion":"24.3.0","dependencies":{"node-fetch":"^3.3.2","@modelcontextprotocol/sdk":"^1.0.0"},"_hasShrinkwrap":false,"devDependencies":{"ts-node":"^10.9.2","typescript":"^5.0.0","@types/node":"^20.0.0"},"_npmOperationalInternal":{"tmp":"tmp/synthetic-web-search-mcp_0.1.0_1769002258474_0.31671298904162803","host":"s3://npm-registry-packages-npm-production"}},"0.1.1":{"name":"synthetic-web-search-mcp","version":"0.1.1","keywords":["mcp","model-context-protocol","web-search","synthetic","search","api"],"author":"parnexcodes","license":"MIT","_id":"synthetic-web-search-mcp@0.1.1","maintainers":[{"name":"parnexcodes","email":"parnexcodes@gmail.com"}],"homepage":"https://github.com/parnexcodes/synthetic-web-search-mcp#readme","bugs":{"url":"https://github.com/parnexcodes/synthetic-web-search-mcp/issues"},"bin":{"synthetic-web-search-mcp":"dist/index.js"},"dist":{"shasum":"7bb20b9e8b94e415f744b4159c2114e428fd40ff","tarball":"https://registry.npmjs.org/synthetic-web-search-mcp/-/synthetic-web-search-mcp-0.1.1.tgz","fileCount":7,"integrity":"sha512-otiLUTJpjBT9uIi3vIlSQFuaCtWDeJLNPbJ42scadHUZ0ed48UKXlFiUMqKu7dJGQ7bsLRmyiUT/RBJDsWrfAA==","signatures":[{"sig":"MEQCIHpSR716flwp7BCBy19ngJnLNoI1Ciyo6NUc/iUSGNWHAiBXaivnfxdl46Nt/krHOZCRR/drZ9QD3GLmhvZ10PR6/A==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":10027},"main":"dist/index.js","type":"module","shasum":"7bb20b9e8b94e415f744b4159c2114e428fd40ff","scripts":{"dev":"node --loader ts-node/esm src/index.ts","build":"tsc","start":"node dist/index.js","watch":"tsc --watch","prepublishOnly":"npm run build"},"_npmUser":{"name":"parnexcodes","email":"parnexcodes@gmail.com"},"_integrity":"sha512-otiLUTJpjBT9uIi3vIlSQFuaCtWDeJLNPbJ42scadHUZ0ed48UKXlFiUMqKu7dJGQ7bsLRmyiUT/RBJDsWrfAA==","repository":{"url":"git+https://github.com/parnexcodes/synthetic-web-search-mcp.git","type":"git"},"_npmVersion":"10.8.3","description":"MCP server for Synthetic Web Search API","directories":{},"_nodeVersion":"24.3.0","dependencies":{"node-fetch":"^3.3.2","@modelcontextprotocol/sdk":"^1.0.0"},"_hasShrinkwrap":false,"devDependencies":{"ts-node":"^10.9.2","typescript":"^5.0.0","@types/node":"^20.0.0"},"_npmOperationalInternal":{"tmp":"tmp/synthetic-web-search-mcp_0.1.1_1769002381235_0.010367156434994529","host":"s3://npm-registry-packages-npm-production"}},"0.1.2":{"name":"synthetic-web-search-mcp","version":"0.1.2","keywords":["mcp","model-context-protocol","web-search","synthetic","search","api"],"author":{"name":"parnexcodes"},"license":"MIT","_id":"synthetic-web-search-mcp@0.1.2","maintainers":[{"name":"parnexcodes","email":"parnexcodes@gmail.com"}],"homepage":"https://github.com/parnexcodes/synthetic-web-search-mcp#readme","bugs":{"url":"https://github.com/parnexcodes/synthetic-web-search-mcp/issues"},"bin":{"synthetic-web-search-mcp":"dist/index.js"},"dist":{"shasum":"9dc09f2d5e9400d744e2a32500fdc941500f5217","tarball":"https://registry.npmjs.org/synthetic-web-search-mcp/-/synthetic-web-search-mcp-0.1.2.tgz","fileCount":8,"integrity":"sha512-YANd1CQQ0+nDoJW3zexruxc6R2HFV7nqJvm0B2o0ZxYSoCMDmGXJDj/FmYqHClHkw8YSWg6w2+/wNDzEZKpr8A==","signatures":[{"sig":"MEUCIDlgyI6BX66k8be17BhkSfLK7zEEnzf6D4kPhcYFPxXIAiEAtHfXmZyOFHPjfAJie2O1F4dFPu9gkNC1qSmX3PucQkQ=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":11666},"main":"dist/index.js","type":"module","types":"./dist/index.d.ts","gitHead":"54d0fac1491ea9754d3d695f831ba29d9166ab25","scripts":{"dev":"node --loader ts-node/esm src/index.ts","build":"tsc","start":"node dist/index.js","watch":"tsc --watch","prepublishOnly":"npm run build"},"_npmUser":{"name":"parnexcodes","email":"parnexcodes@gmail.com"},"repository":{"url":"git+https://github.com/parnexcodes/synthetic-web-search-mcp.git","type":"git"},"_npmVersion":"11.6.2","description":"MCP server for Synthetic Web Search API","directories":{},"_nodeVersion":"24.11.1","dependencies":{"node-fetch":"^3.3.2","@modelcontextprotocol/sdk":"^1.0.0"},"_hasShrinkwrap":false,"devDependencies":{"ts-node":"^10.9.2","typescript":"^5.0.0","@types/node":"^20.0.0"},"_npmOperationalInternal":{"tmp":"tmp/synthetic-web-search-mcp_0.1.2_1769065005388_0.04801352760042077","host":"s3://npm-registry-packages-npm-production"}},"0.1.3":{"name":"synthetic-web-search-mcp","version":"0.1.3","keywords":["mcp","model-context-protocol","web-search","synthetic","search","api"],"author":{"name":"parnexcodes"},"license":"MIT","_id":"synthetic-web-search-mcp@0.1.3","maintainers":[{"name":"parnexcodes","email":"parnexcodes@gmail.com"}],"homepage":"https://github.com/parnexcodes/synthetic-web-search-mcp#readme","bugs":{"url":"https://github.com/parnexcodes/synthetic-web-search-mcp/issues"},"bin":{"synthetic-web-search-mcp":"dist/index.js"},"dist":{"shasum":"1a9ea2530e278cd126a0be6a582b82c9bde3a41e","tarball":"https://registry.npmjs.org/synthetic-web-search-mcp/-/synthetic-web-search-mcp-0.1.3.tgz","fileCount":8,"integrity":"sha512-TZTHl/etk2rmJgj1e+IfC+ADO2I+XSmHPnErH3lC6JRVWkgXKLVbRFJZ9B4A3D0naYHLJoYvxMtEkoUO/59o5w==","signatures":[{"sig":"MEUCIQD8aNqaVkpb04XUI7XWL6siGP/P5tH94IIKkQaqMeghggIgGr4thauCPJf8jcJhs6PdhlgM3eDhGB8gLRkBUJeI16E=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":11727},"main":"dist/index.js","type":"module","types":"./dist/index.d.ts","gitHead":"c8de1c39f14140bfaeb59c742c6de0b1596fc546","scripts":{"dev":"node --loader ts-node/esm src/index.ts","build":"tsc && sed -i '1i#!/usr/bin/env node' dist/index.js","start":"node dist/index.js","watch":"tsc --watch","prepublishOnly":"npm run build"},"_npmUser":{"name":"parnexcodes","email":"parnexcodes@gmail.com"},"repository":{"url":"git+https://github.com/parnexcodes/synthetic-web-search-mcp.git","type":"git"},"_npmVersion":"11.6.2","description":"MCP server for Synthetic Web Search API","directories":{},"_nodeVersion":"24.11.1","dependencies":{"node-fetch":"^3.3.2","@modelcontextprotocol/sdk":"^1.0.0"},"_hasShrinkwrap":false,"devDependencies":{"ts-node":"^10.9.2","typescript":"^5.0.0","@types/node":"^20.0.0"},"_npmOperationalInternal":{"tmp":"tmp/synthetic-web-search-mcp_0.1.3_1769149141829_0.618534956402899","host":"s3://npm-registry-packages-npm-production"}},"0.1.4":{"name":"synthetic-web-search-mcp","version":"0.1.4","keywords":["mcp","model-context-protocol","web-search","synthetic","search","api"],"author":{"name":"parnexcodes"},"license":"MIT","_id":"synthetic-web-search-mcp@0.1.4","maintainers":[{"name":"parnexcodes","email":"parnexcodes@gmail.com"}],"homepage":"https://github.com/parnexcodes/synthetic-web-search-mcp#readme","bugs":{"url":"https://github.com/parnexcodes/synthetic-web-search-mcp/issues"},"bin":{"synthetic-web-search-mcp":"dist/index.js"},"dist":{"shasum":"ea15e2874a1b89f217856f015f55b207d36a72c2","tarball":"https://registry.npmjs.org/synthetic-web-search-mcp/-/synthetic-web-search-mcp-0.1.4.tgz","fileCount":8,"integrity":"sha512-3o0m9QUId5aVxKCTlFR8TTZLc2enFw+PQa7gE7UL4LAWSVhzzLVjrWmbWgUe+e5wGzFjxXdXscbUcg9SQc1KKg==","signatures":[{"sig":"MEYCIQCpWCwuk5LlCwQeVwf6RuFcKRifse31AzsWu/gZ7ORIxwIhAMlS178BgUsrEulkNZZ6RIfHm3p9T3jc/27Op0fMYf/E","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":10536},"main":"dist/index.js","type":"module","types":"./dist/index.d.ts","gitHead":"2b8deb9a9854bab2aeeea7b2816cca175887a7ff","scripts":{"dev":"node --loader ts-node/esm src/index.ts","build":"tsc && sed -i '1i#!/usr/bin/env node' dist/index.js","start":"node dist/index.js","watch":"tsc --watch","prepublishOnly":"npm run build"},"_npmUser":{"name":"parnexcodes","email":"parnexcodes@gmail.com"},"repository":{"url":"git+https://github.com/parnexcodes/synthetic-web-search-mcp.git","type":"git"},"_npmVersion":"11.6.2","description":"MCP server for Synthetic Web Search API","directories":{},"_nodeVersion":"24.11.1","dependencies":{"node-fetch":"^3.3.2","@modelcontextprotocol/sdk":"^1.0.0"},"_hasShrinkwrap":false,"devDependencies":{"ts-node":"^10.9.2","typescript":"^5.0.0","@types/node":"^20.0.0"},"_npmOperationalInternal":{"tmp":"tmp/synthetic-web-search-mcp_0.1.4_1769150282101_0.659668216898271","host":"s3://npm-registry-packages-npm-production"}},"0.1.5":{"name":"synthetic-web-search-mcp","version":"0.1.5","type":"module","description":"MCP server for Synthetic Web Search API","main":"dist/index.js","bin":{"synthetic-web-search-mcp":"dist/index.js"},"scripts":{"build":"tsc && printf '#!/usr/bin/env node\\n' | cat - dist/index.js > dist/index.js.tmp && mv dist/index.js.tmp dist/index.js","prepublishOnly":"npm run build","start":"node dist/index.js","dev":"node --loader ts-node/esm src/index.ts","watch":"tsc --watch"},"keywords":["mcp","model-context-protocol","web-search","synthetic","search","api"],"author":{"name":"parnexcodes"},"license":"MIT","repository":{"type":"git","url":"git+https://github.com/parnexcodes/synthetic-web-search-mcp.git"},"homepage":"https://github.com/parnexcodes/synthetic-web-search-mcp#readme","bugs":{"url":"https://github.com/parnexcodes/synthetic-web-search-mcp/issues"},"dependencies":{"@modelcontextprotocol/sdk":"^1.0.0","node-fetch":"^3.3.2"},"devDependencies":{"@types/node":"^20.0.0","ts-node":"^10.9.2","typescript":"^5.0.0"},"gitHead":"d366dce061a4f9817d78bc189692ece9f4df7e9d","types":"./dist/index.d.ts","_id":"synthetic-web-search-mcp@0.1.5","_nodeVersion":"24.11.1","_npmVersion":"11.6.2","dist":{"integrity":"sha512-2tzvjU+UnVPM3hYTkNzCJs1/yFp2QOPNEFOTEK5nzZtmMnKc5Bffx6oNiEUqKPPf4wA2N17g1kGaxDJJHMNFuw==","shasum":"e761fb8133f5d4ca60c9047396f7a7e0715a97fe","tarball":"https://registry.npmjs.org/synthetic-web-search-mcp/-/synthetic-web-search-mcp-0.1.5.tgz","fileCount":8,"unpackedSize":11945,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEYCIQCpZK4GCcpw+PNgZXZTouWwUgASVumNQ2TPfobI/Hcb7QIhAO+jebGmYn4WvnzDPTXO3BrPadLPFKpjFdLD31NJhlIb"}]},"_npmUser":{"name":"parnexcodes","email":"parnexcodes@gmail.com"},"directories":{},"maintainers":[{"name":"parnexcodes","email":"parnexcodes@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/synthetic-web-search-mcp_0.1.5_1774248174334_0.21134491039426262"},"_hasShrinkwrap":false}},"time":{"created":"2026-01-21T13:30:58.473Z","modified":"2026-03-23T06:42:54.914Z","0.1.0":"2026-01-21T13:30:58.611Z","0.1.1":"2026-01-21T13:33:01.374Z","0.1.2":"2026-01-22T06:56:45.541Z","0.1.3":"2026-01-23T06:19:01.980Z","0.1.4":"2026-01-23T06:38:02.245Z","0.1.5":"2026-03-23T06:42:54.500Z"},"bugs":{"url":"https://github.com/parnexcodes/synthetic-web-search-mcp/issues"},"author":{"name":"parnexcodes"},"license":"MIT","homepage":"https://github.com/parnexcodes/synthetic-web-search-mcp#readme","keywords":["mcp","model-context-protocol","web-search","synthetic","search","api"],"repository":{"type":"git","url":"git+https://github.com/parnexcodes/synthetic-web-search-mcp.git"},"description":"MCP server for Synthetic Web Search API","maintainers":[{"name":"parnexcodes","email":"parnexcodes@gmail.com"}],"readme":"# Synthetic Web Search MCP Server\n\nA Model Context Protocol (MCP) server that exposes the Synthetic web search API as a tool for use with Claude and other MCP-compatible applications.\n\n[![npm version](https://badge.fury.io/js/synthetic-web-search-mcp.svg)](https://www.npmjs.com/package/synthetic-web-search-mcp)\n\n## Overview\n\nThis server provides a `search_web` tool that allows MCP clients to perform web searches using the [Synthetic API](https://api.synthetic.new/). Search results are returned as formatted JSON containing URL, title, text, and published date fields.\n\n## Quick Start with Claude Code\n\nAdd the MCP server to Claude Code with a single command:\n\n```bash\nclaude mcp add synthetic-web-search -e SYNTHETIC_API_KEY=your_api_key_here -- npx -y synthetic-web-search-mcp@latest\n```\n\nReplace `your_api_key_here` with your actual [Synthetic API key](https://api.synthetic.new/).\n\n## Usage with Claude Desktop\n\nTo use this MCP server with Claude Desktop, add the following to your Claude Desktop configuration file:\n\n**macOS**: `~/Library/Application Support/Claude/claude_desktop_config.json`\n**Windows**: `%APPDATA%\\Claude\\claude_desktop_config.json`\n\n```json\n{\n  \"mcpServers\": {\n    \"synthetic-web-search\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"synthetic-web-search-mcp@latest\"],\n      \"env\": {\n        \"SYNTHETIC_API_KEY\": \"your_actual_api_key_here\"\n      }\n    }\n  }\n}\n```\n\nAfter adding the configuration, restart Claude Desktop. You can then use the web search tool in your conversations.\n\n## Usage with opencode\n\nTo use this MCP server with opencode, add the following to your opencode configuration:\n\n```json\n{\n  \"mcp\": {\n    \"synthetic-web-search\": {\n      \"type\": \"local\",\n      \"command\": [\"npx\", \"-y\", \"synthetic-web-search-mcp@latest\"],\n      \"environment\": {\n        \"SYNTHETIC_API_KEY\": \"your_actual_api_key_here\"\n      },\n      \"enabled\": true\n    }\n  }\n}\n```\n\nReplace `your_actual_api_key_here` with your actual [Synthetic API key](https://api.synthetic.new/). Restart opencode after adding the configuration.\n\n## Local Development & Testing\n\n### 1. Prerequisites\n\n- Node.js 18+\n- A [Synthetic API key](https://api.synthetic.new/)\n\n### 2. Install & build\n\n```bash\nnpm install\nnpm run build\n```\n\n### 3. Test with MCP Inspector\n\nThe fastest way to verify the server interactively without any client configuration:\n\n```bash\nSYNTHETIC_API_KEY=your_key_here \\\n  npx @modelcontextprotocol/inspector node dist/index.js\n```\n\nThis opens a browser UI where you can invoke `search_web` directly. Try:\n- `query` only → `text` is capped at the default 1000 characters.\n- `query` + `max_text_length: 200` → tighter truncation to quickly scan results.\n- `query` + `max_text_length: 5000` → more content when you need full detail.\n\n### 4. Test with Claude Code (local build)\n\n```bash\nclaude mcp add synthetic-web-search \\\n  -e SYNTHETIC_API_KEY=your_key_here \\\n  -- node /absolute/path/to/synthetic-web-search-mcp/dist/index.js\n```\n\n### 5. Test with Claude Desktop (local build)\n\nEdit `~/Library/Application Support/Claude/claude_desktop_config.json` (macOS) or `%APPDATA%\\Claude\\claude_desktop_config.json` (Windows):\n\n```json\n{\n  \"mcpServers\": {\n    \"synthetic-web-search\": {\n      \"command\": \"node\",\n      \"args\": [\"/absolute/path/to/synthetic-web-search-mcp/dist/index.js\"],\n      \"env\": {\n        \"SYNTHETIC_API_KEY\": \"your_key_here\"\n      }\n    }\n  }\n}\n```\n\nRestart Claude Desktop after saving the file.\n\n## Available Tools\n\n### search_web\n\nSearch the web using the Synthetic API.\n\n**Arguments:**\n- `query` (string, required): The search query string\n- `max_text_length` (number, optional, default: `1000`): Maximum number of characters to include in the `text` field of each result. Useful for preventing large snippets from flooding the context window. Results exceeding this length are truncated with `...`. Pass a larger value when you need the full content of a result.\n\n**Example:**\n```\nSearch for \" TypeScript documentation\"\n```\n\n**Returns:**\nA JSON array of search results, each containing:\n- `url`: The link to the search result\n- `title`: The title of the page\n- `text`: A snippet or content from the page\n- `published`: Publication date (if available)\n\n## API Details\n\n- **Endpoint**: `https://api.synthetic.new/v2/search`\n- **Method**: POST\n- **Authentication**: Bearer token via `Authorization` header\n- **Request Body**: JSON with `query` field\n\n## Project Structure\n\n```\nsynthetic-web-search-mcp/\n├── package.json\n├── tsconfig.json\n├── .env.example\n├── README.md\n├── src/\n│   └── index.ts\n└── dist/          (generated after build)\n    ├── index.js\n    └── index.d.ts\n```\n\n## License\n\n[MIT](https://github.com/parnexcodes/synthetic-web-search-mcp/blob/main/LICENSE)\n","readmeFilename":"README.md"}