Skip to main content
Glama
joephaser

Synthetic Search MCP Server

by joephaser

πŸ” Synthetic Search MCP Server

License: MIT Node.js TypeScript

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.


πŸš€ Installation

Prerequisites

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

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.


Made with ❀️ for the MCP community

Report Bug β€’ Request Feature

Install Server
A
security – no known vulnerabilities
A
license - permissive license
A
quality - confirmed to work

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/joephaser/synthetic-search-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server