https://github.com/ChristianSch/openrouter-websearch-mcp

An MCP server providing websearch using openrouter :online
https://github.com/ChristianSch/openrouter-websearch-mcp

Last synced: 2 months ago
JSON representation

An MCP server providing websearch using openrouter :online

• Host: GitHub
• URL: https://github.com/ChristianSch/openrouter-websearch-mcp
• Owner: ChristianSch
• License: mit
• Created: 2025-04-06T17:32:54.000Z (7 months ago)
• Default Branch: main
• Last Pushed: 2025-04-06T17:45:09.000Z (7 months ago)
• Last Synced: 2025-04-15T11:49:21.133Z (7 months ago)
• Language: Go
• Size: 4.88 KB
• Stars: 1
• Watchers: 1
• Forks: 1
• Open Issues: 1
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

• awesome-mcp-servers - **openrouter-websearch-mcp** - An MCP server providing websearch using openrouter :online `go` `mcp` `server` `web` `go install ChristianSch/openrouter-websearch-mcp@latest` (⚙️ DevOps)
• awesome-mcp-servers - **openrouter-websearch-mcp** - An MCP server providing websearch using openrouter :online `go` `mcp` `server` `web` `go install ChristianSch/openrouter-websearch-mcp@latest` (DevOps)

README

          
# OpenRouter Web Search MCP Server

This project implements an [MCP (Model Context Protocol)](https://github.com/mark3labs/mcp-go) server that provides a `search_web` tool. The tool performs a web search using OpenRouter's online models to generate concise, up-to-date answers.

## Features

- Exposes an MCP-compatible server over stdio

- Provides a `search_web` tool that:

  - Accepts a search query string

  - Uses OpenRouter's online models to generate a fact-based answer

  - Returns the answer as plain text

## Requirements

- Go 1.18+

- An OpenRouter API key

## Environment Variables

| Variable             | Description                                               | Required | Default                                               |

|----------------------|-----------------------------------------------------------|----------|-------------------------------------------------------|

| `OPENROUTER_API_KEY`| Your OpenRouter API key                                   | **Yes**  |                                                       |

| `MODEL_NAME`         | OpenRouter model name (should support `:online` suffix)  | No       | `google/gemini-2.5-pro-exp-03-25:free:online`         |

## Installation 

To install the MCP server, you can use the following command:

```bash

go install github.com/ChristianSch/openrouter-websearch-mcp

```

## Usage

Run the server:

```bash

{

    "mcpServers": {

        "web-search": {

            "command": "openrouter-websearch-mcp",

            "env": {

                "OPENROUTER_API_KEY": "sk-or-v1-..."

            }

        }

    }

}

```