Synthetic Search MCP Server
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Synthetic Search MCP Server search for the latest TypeScript 5.4 features"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
🔍 Synthetic Search MCP Server
Web search capabilities for your MCP-enabled applications with zero-data-retention privacy.
Installation • Usage • Configuration • API Reference
✨ Features
🔒 Privacy First
Zero-data-retention search ensures your queries remain private and secure.
⚡ Fast & Accurate
Get relevant web search results in milliseconds with high-quality ranking.
🔧 Easy Integration
Simple MCP tool interface that works seamlessly with OpenCode and other MCP clients.
📦 Zero Dependencies
Lightweight implementation with minimal external dependencies for reliability.
Related MCP server: DeepSearch MCP
🚀 Installation
Prerequisites
Node.js 20 or higher
A Synthetic API key (Get one here)
Quick Start
# Clone the repository
git clone https://github.com/joephaser/synthetic-search-mcp.git
cd synthetic-search-mcp
# Install dependencies
npm install
# Build the project
npm run build🎯 Usage
1. Configure Your API Key
# Option 1: Environment variable
export SYNTHETIC_API_KEY="your-api-key-here"
# Option 2: Using .env file
cp .env.example .env
# Edit .env and add your API key2. Run the Server
# Production mode
npm start
# Development mode with hot reload
npm dev3. Test It
export SYNTHETIC_API_KEY="your-api-key"
npm test⚙️ Configuration
Claude Code CLI Integration
Add this MCP server to your Claude Code configuration using the claude mcp add command:
# Add the MCP server with your API key
claude mcp add --transport stdio --env SYNTHETIC_API_KEY=your-api-key-here synthetic-search -- node /path/to/synthetic-search-mcp/dist/index.jsOr manually edit ~/.claude.json and add:
{
"mcpServers": {
"synthetic-search": {
"type": "stdio",
"command": "node",
"args": ["/path/to/synthetic-search-mcp/dist/index.js"],
"env": {
"SYNTHETIC_API_KEY": "your-api-key-here"
}
}
}
}Note: Replace
/path/to/synthetic-search-mcpwith the actual path to your installation andyour-api-key-herewith your Synthetic API key.
OpenCode Integration
Add this MCP server to your OpenCode configuration at ~/.config/opencode/opencode.json:
{
"$schema": "https://opencode.ai/config.json",
"mcp": {
"synthetic-search": {
"type": "local",
"command": ["node", "/path/to/synthetic-search-mcp/dist/index.js"],
"environment": {
"SYNTHETIC_API_KEY": "your-api-key-here"
},
"enabled": true
}
}
}Note: Replace
/path/to/synthetic-search-mcpwith the actual path to your installation andyour-api-key-herewith your Synthetic API key.
📚 API Reference
Tool: synthetic_search
Search the web using Synthetic's privacy-focused search API.
Parameters
Parameter | Type | Required | Description |
|
| ✅ Yes | The search query to execute |
Example Request
{
"query": "latest TypeScript features 2024"
}Response Format
{
"results": [
{
"title": "What's New in TypeScript 5.4",
"url": "https://example.com/article",
"date": "2024-03-15",
"snippet": "TypeScript 5.4 introduces several exciting features..."
}
]
}Result Fields
Title - The page title
URL - Direct link to the source
Date - Publication date (when available)
Snippet - Relevant excerpt from the content
🛠️ Development
# Run in development mode
npm run dev
# Build for production
npm run build
# Run linting
npm run lint
# Run tests
npm test📄 License
This project is licensed under the MIT License - see the LICENSE file for details.
Made with ❤️ for the MCP community
Available Tools
1 toolsynthetic_searchA
Search the web using Synthetic's zero-data-retention search API. Returns relevant web results including URL, title, snippet text, and publication date.
Inputs: query (required).
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 1 tool
With only one tool, there is no possibility of ambiguity or overlap between tools, as there are no other tools to confuse it with. The tool's purpose is clearly defined and distinct by default.
The single tool name follows a consistent snake_case pattern, and with only one tool, there is no inconsistency to evaluate. The naming is straightforward and appropriate for its function.
A single tool is generally too few for a server's purpose, as it limits functionality and suggests an incomplete or overly narrow scope. For a search server, one tool might suffice for basic searches, but it lacks operations like filtering, pagination, or advanced queries that would enhance utility.
The tool provides a core search function, but there are notable gaps such as no options for refining searches (e.g., by date, domain, or language) or handling search metadata. It covers the basic operation but lacks features that would make the surface more robust and versatile for agents.
Related MCP Connectors
Live AI-native web search with citations. One tool for every MCP client. Flat per-request pricing.
Free web search for AI agents. No API key required. Hosted MCP in active development.
Multi-engine search for AI agents. Trust scoring, local corpus, MCP-native. Self-hostable, BYOK.
Unofficial Serper MCP — wraps the Serper Google Search API (serper.dev)
Related MCP Servers
- AlicenseNot gradedqualityNot gradedmaintenanceProvides Google search capabilities, web content extraction, and screenshot functionality with advanced bot detection avoidance through the MCP protocol.14 npm6-
- AlicenseBqualityDmaintenanceEnables web search and site-specific search capabilities through the Deepsearch model. Provides unified access to broad web retrieval and targeted site search functionality within the MCP ecosystem.25Apache 2.0
- AlicenseNot gradedqualityBmaintenanceFree 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.33MIT
- AlicenseNot gradedqualityDmaintenanceProvides comprehensive search capabilities including web search, content extraction, news search, academic search, and AI-powered multi-source research. Enables natural language access to web content and research through a production-ready MCP server.MIT