ReActMCP Web Search

v1.0.0Search & Data Extractionstable

An MCP server that integrates real-time web search capabilities into AI assistants using the Exa API, providing both basic and advanced search functionality with formatted markdown results.

mcpmcp-clientmcp-server
Share:
143
Stars
0
Downloads
0
Weekly
0/5

What is ReActMCP Web Search?

ReActMCP Web Search is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to mcp server that integrates real-time web search capabilities into ai assistants using the exa api, providing both basic and advanced search functionality with formatted markdown results.

An MCP server that integrates real-time web search capabilities into AI assistants using the Exa API, providing both basic and advanced search functionality with formatted markdown results.

This server falls under the Search & Data Extraction category on MCPgee, the world's largest MCP server directory with 33,000+ servers.

Features

  • An MCP server that integrates real-time web search capabilit

Use Cases

An MCP server that integrates real-time web search capabilities into AI assistan
mshojaei77

Maintainer

LicenseMIT
Languagepython
Versionv1.0.0
UpdatedApr 16, 2026
Statushealthy
Maintenanceactive

Works with

ClaudeOpenAIwindowsmacoslinux

Installation

Manual Installation

npx reactmcp-web-search

Configuration

Configuration Details

Config File

claude_desktop_config.json

Performance

Response Metrics

Response Time< 200ms
ThroughputMedium

Resource Usage

Memory UsageLow
CPU UsageLow

How to Set Up and Use ReActMCP Web Search

ReActMCP Web Search is an MCP server that integrates real-time web search into AI assistants using the Exa API, providing both a basic search tool and an advanced search tool with domain filtering, required-text inclusion, and date-range constraints. Results are returned as Markdown with inline titles, URLs, and content summaries so AI assistants can immediately cite sources. It is part of the broader ReActMCP project and is designed to be dropped into any MCP-compatible framework to give the assistant live internet access without building a custom integration.

Prerequisites

  • Python 3.8 or higher installed
  • An Exa API key obtained from exa.ai
  • pip for installing Python packages
  • An MCP-compatible client such as Claude Desktop
  • Optional: OpenAI API key if using the bundled GPT-4o assistant mode
1

Clone the ReActMCP repository

The web search MCP server lives inside the ReActMCP repository. Clone it and enter the directory.

git clone https://github.com/mshojaei77/ReActMCP.git
cd ReActMCP
2

Set up a virtual environment

Create an isolated Python environment to keep dependencies clean.

python -m venv venv
source venv/bin/activate  # Windows: venv\Scripts\activate
3

Install required packages

Install all dependencies listed in requirements.txt, which includes the Exa Python client, python-dotenv, and the MCP framework.

pip install -r requirements.txt
4

Add your Exa API key to a .env file

The server reads EXA_API_KEY from a .env file in the project root. Create the file with your key.

EXA_API_KEY=your_exa_api_key_here
5

Start the MCP server

Run the web_search.py script. It exposes the search_web and advanced_search_web tools over stdio to any connected MCP client.

python web_search.py

ReActMCP Web Search Examples

Client configuration

Claude Desktop config that launches the ReActMCP web search server via Python with the Exa API key passed as an environment variable.

{
  "mcpServers": {
    "reactmcp-web-search": {
      "command": "python",
      "args": ["/absolute/path/to/ReActMCP/web_search.py"],
      "env": {
        "EXA_API_KEY": "your_exa_api_key_here"
      }
    }
  }
}

Prompts to try

Example prompts using the search_web and advanced_search_web tools exposed by the server.

- "Search the web for the latest Python 3.13 release notes and summarize what changed"
- "Use advanced search to find articles from techcrunch.com published in the last 30 days about AI funding"
- "Find recent tutorials about FastAPI and list the top 5 results with their URLs"

Troubleshooting ReActMCP Web Search

Server exits immediately with 'EXA_API_KEY not set' or similar error

Make sure the .env file exists in the same directory as web_search.py and contains EXA_API_KEY=<your key>. Alternatively, set the environment variable directly in the MCP client's config JSON under the 'env' key.

advanced_search_web returns no results when using domain filters

Domain filters in the include_domains parameter must be bare hostnames without 'https://' (e.g., 'techcrunch.com' not 'https://techcrunch.com'). Also ensure the date range is not too narrow for the chosen domain.

Import errors when starting the server

Activate the virtual environment first ('source venv/bin/activate') then confirm the packages are installed with 'pip list | grep exa'. If missing, re-run 'pip install -r requirements.txt'.

Frequently Asked Questions about ReActMCP Web Search

What is ReActMCP Web Search?

ReActMCP Web Search is a Model Context Protocol (MCP) server that mcp server that integrates real-time web search capabilities into ai assistants using the exa api, providing both basic and advanced search functionality with formatted markdown results. It connects AI assistants to external tools and data sources through a standardized interface.

How do I install ReActMCP Web Search?

Follow the installation instructions on the ReActMCP Web Search GitHub repository. Clone the repo, install dependencies, and add the server config to your AI client.

Which AI clients work with ReActMCP Web Search?

ReActMCP Web Search works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.

Is ReActMCP Web Search free to use?

Yes, ReActMCP Web Search is open source and available under the MIT license. You can use it freely in both personal and commercial projects.

Browse More Search & Data Extraction MCP Servers

Explore all search & data extraction servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.

Quick Config Preview

{ "mcpServers": { "reactmcp-web-search": { "command": "npx", "args": ["-y", "reactmcp-web-search"] } } }

Add this to your claude_desktop_config.json or .cursor/mcp.json

Read the full setup guide →

Ready to use ReActMCP Web Search?

Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.

33,000+ ServersFree & Open SourceStep-by-Step Guides