---
slug: "openrouter"
source_type: "readme"
source_url: "https://cdn.jsdelivr.net/gh/joaomj/openrouter-search-server@master/README.md"
repo: "https://github.com/joaomj/openrouter-search-server"
source_file: "README.md"
branch: "master"
---
# Attention

Archived repo. For future developments see: https://github.com/joaomj/openrouter-websearch-mcp

# OpenRouter Search MCP Server

This is a Model Context Protocol (MCP) server designed to provide web search capabilities by leveraging the OpenRouter API.

## Features

*   **Web Search via OpenRouter:** Utilizes the OpenRouter API to perform web searches.
*   **Specific Model:** Uses the `google/gemini-2.5-pro-preview-03-25` model.
*   **Raw Text Output:** The server returns the direct, unparsed text response generated by the AI model.
*   **MCP Integration:** Exposes a simple `web_search` tool compatible with MCP clients.

## Installation

1.  **Clone:** Clone this repository to your local machine.
    ```bash
    git clone https://github.com/joaomj/openrouter-search-server.git
    cd openrouter-search-server
    ```
2.  **Install Dependencies:**
    ```bash
    npm install
    ```
3.  **Build:** Compile the TypeScript code.
    ```bash
    npm run build
    ```

## Configuration

1.  **API Key:** Ensure you have an API key from [OpenRouter](https://openrouter.ai/).
2.  **MCP Settings:** Add the following configuration block to your MCP client's settings file (e.g., `~/.vscode-server/data/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json` for VS Code Remote/Codespaces or `~/Library/Application Support/Claude/claude_desktop_config.json` for Claude Desktop App):

    ```json
    {
      "mcpServers": {
        "openrouter-search": {
          "command": "node",
          "args": [
            "/home/<user>/Cline/MCP/openrouter-search-server/build/index.js"
          ],
          "env": {
            "OPENROUTER_API_KEY": "YOUR_OPENROUTER_API_KEY_HERE"
          },
          "disabled": false,
          "autoApprove": []
        }
        // ... other servers
      }
    }
    ```

    *   Replace `/home/<user>/Cline/MCP/openrouter-search-server/build/index.js` with the actual absolute path to the built `index.js` file on your system if you cloned it elsewhere.
    *   Replace `YOUR_OPENROUTER_API_KEY_HERE` with your actual OpenRouter API key.

    **Important:** The server requires the `OPENROUTER_API_KEY` environment variable to be set. Never commit your API key directly into the code or the repository.

## Usage

Once the server is configured and running (either manually via `npm start` in its directory or automatically via your MCP client), you can use the `web_search` tool.

**Tool:** `web_search`

**Server Name:** `openrouter-search` (or whatever key you used in the MCP settings)

**Input:**
*   `query` (string, required): The search query you want to perform.

**Output:**
*   A text string containing the raw response from the OpenRouter API's `google/gemini-2.5-pro-preview-03-25` model.

**Example MCP Tool Call:**

```xml
<use_mcp_tool>
<server_name>openrouter-search</server_name>
<tool_name>web_search</tool_name>
<arguments>
{
  \"query\": \"What is the latest version of the MCP SDK?\"
}
</arguments>
</use_mcp_tool>
```

## License
MIT.