MCP.so
Sign In

OpenAI Web Search MCP Server

@bitibi

About OpenAI Web Search MCP Server

A server for handling OpenAI web search using MCP (Multi-Config Protocol)

Basic information

Category

AI & Agents

Runtime

node

Transports

stdio

Publisher

bitibi

Config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "OpenAI-WebSearch-MCP-Server": {
      "command": "npx",
      "args": [
        "openai-websearch-mcp-server"
      ]
    }
  }
}

Tools

No tools detected

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

Overview

What is OpenAI Web Search MCP Server?

A TypeScript‑based MCP server that lets AI models perform real‑time web searches through the OpenAI API, using the Responses API’s web_search_preview feature. It is built for developers who want to add live web search capabilities to any MCP‑compatible client (e.g., Claude Desktop).

How to use OpenAI Web Search MCP Server?

Install with npx openai-websearch-mcp-server or npm install -g openai-websearch-mcp-server, then set the OPENAI_API_KEY environment variable. Run the server with openai-websearch-mcp. Configure your MCP client to launch the server and send tool calls to the web_search tool, which accepts a query string and returns results from across the internet.

Key features of OpenAI Web Search MCP Server

  • Real‑time web search via OpenAI’s web_search_preview capability
  • Simple MCP‑compliant tool interface (web_search)
  • Run directly with npx or install globally
  • Port configurable via the PORT environment variable
  • Works with any MCP client (Claude Desktop, etc.)

Use cases of OpenAI Web Search MCP Server

  • Enabling an AI assistant to look up current news or facts
  • Providing up‑to‑date information to a chatbot without manual data refreshes
  • Adding a search tool to your custom MCP‑powered application

FAQ from OpenAI Web Search MCP Server

What does the server do?

It exposes a web_search tool that uses OpenAI’s Responses API to perform live web searches, returning results directly to an MCP client.

How do I set my OpenAI API key?

Set the environment variable OPENAI_API_KEY before running the server: export OPENAI_API_KEY='your-api-key-here'.

Do I need any other services?

Only an OpenAI API key with access to the Responses API’s web_search_preview feature. No additional database or third‑party search engine is required.

How do I change the port?

Set the PORT environment variable, e.g., PORT=8080 openai-websearch-mcp. The default port is 3000.

How is this server intended to be used?

It is designed to be launched by an MCP client (like Claude Desktop) via the command line, with the API key provided in the client configuration’s environment.

Comments

More AI & Agents MCP servers