# perplexity-search-mcp

MCP server for web search via [Perplexity Sonar Pro](https://docs.perplexity.ai/) through [OpenRouter API](https://openrouter.ai/).

## Setup

### 1. Get an OpenRouter API Key

Get your API key from [openrouter.ai/keys](https://openrouter.ai/keys).

### 2. Add to MCP Client

Add to your MCP client config (e.g., AiderDesk, Claude Desktop):

```json
{
  "mcpServers": {
    "perplexity-search": {
      "command": "npx",
      "args": ["tsx", "src/index.ts"],
      "cwd": "/path/to/perplexity-search-mcp",
      "env": {
        "OPENROUTER_API_KEY": "sk-or-..."
      }
    }
  }
}
```

Or with the built version:

```json
{
  "mcpServers": {
    "perplexity-search": {
      "command": "node",
      "args": ["dist/index.js"],
      "cwd": "/path/to/perplexity-search-mcp",
      "env": {
        "OPENROUTER_API_KEY": "sk-or-..."
      }
    }
  }
}
```

## Tool

### `perplexity_search`

Search the web using Perplexity Sonar Pro.

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `query` | string | ✅ | The search query |
| `model` | string | ❌ | Model to use (default: `perplexity/sonar-pro-search`) |

**Available models:**
- `perplexity/sonar-pro-search` (default) — deeper search, more citations
- `perplexity/sonar-search` — faster, lighter

## Development

```bash
pnpm install
pnpm build
pnpm dev    # run with tsx (no build needed)
```

## License

MIT