---

✨ 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.

---

🚀 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 key

2. Run the Server

# Production mode
npm start

# Development mode with hot reload
npm dev

3. 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.js

Or 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-mcp with the actual path to your installation and your-api-key-here with 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-mcp with the actual path to your installation and your-api-key-here with your Synthetic API key.

---

📚 API Reference

Tool: synthetic_search

Search the web using Synthetic's privacy-focused search API.

Parameters

Parameter	Type	Required	Description
query	string	✅ 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.

---