Synthetic Web Search

Provides a web search tool for MCP clients by querying the Synthetic API and returning structured results.

typescript

2

GitHub Stars

typescript

Language

4 months ago

First Indexed

2 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "parnexcodes-synthetic-web-search-mcp": {
      "command": "synthetic-web-search-mcp",
      "args": [],
      "env": {
        "SYNTHETIC_API_KEY": "your_actual_api_key_here"
      }
    }
  }
}

You can use the Synthetic Web Search MCP Server to perform web searches via MCP-compatible clients. It exposes a single tool, search_web, which returns formatted results that you can feed into your conversations or workflows.

How to use

You interact with the server by invoking the search_web tool from your MCP client. Provide a textual query, and you will receive a JSON array where each result includes a URL, a title, a snippet of text, and a published date if available. Integrate these results into your prompts, summaries, or research tasks to augment your workflow with live web information.

How to install

Prerequisites: ensure you have Node.js and npm installed, or Bun if you prefer. The server can be installed globally for use with any MCP client, or used with local runtime if you install it locally.

npm install -g synthetic-web-search-mcp

bun add -g synthetic-web-search-mcp

Configuration and usage with Claude/Desktop clients

Set your Synthetic API key as an environment variable so the server can authenticate against the Synthetic API.

export SYNTHETIC_API_KEY=your_actual_api_key_here

Alternatively, place it in a .env file in the project root (copy the example if provided) so the server can load it automatically.

SYNTHETIC_API_KEY=your_actual_api_key_here

Claude Desktop configuration example

{
  "mcpServers": {
    "synthetic-web-search": {
      "command": "synthetic-web-search-mcp",
      "env": {
        "SYNTHETIC_API_KEY": "your_actual_api_key_here"
      }
    }
  }
}

Testing with MCP Inspector

If you want to test the server without Claude Desktop, use the MCP inspector to list tools and run test queries against search_web.

npx @modelcontextprotocol/inspector synthetic-web-search-mcp

Testing notes

In testing, you should be able to provide a query such as "TypeScript documentation" and review the returned JSON results, including each result’s URL, title, snippet text, and publication date if available.

Security considerations

Keep your Synthetic API key secure. Do not expose it in client-side code or public repositories. Use environment isolation when running locally and rotate keys as needed.

Available tools

search_web

Search the web using the Synthetic API and return a JSON array of results. Each result includes url, title, text, and published date.