OpenRouter Search MCP Server NPX

April 18, 2025 ยท View on GitHub

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:online model. The :online suffix enables the model's web search functionality.
  • 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.

Configuration

  1. API Key: Ensure you have an API key from OpenRouter.

  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):

    {
  "mcpServers": {
    "openrouter-search": {
      "command": "npx",
      "args": [
        "-y",
        "openrouter-search"
       ],
      "env": {
        "OPENROUTER_API_KEY": "YOUR_OPENROUTER_API_KEY_HERE"
      }
    }
  }
}
    • 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

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:online model.

Example MCP Tool Call:

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