grok_searchLABSCO SUMMARY
Grok's live search, split by where the answer lives: the web, the news or Twitter/X.
Comprehensive mode is what sets it apart: instead of a list of links it returns key findings, a timeline and direct quotes, which suits a news question, while basic mode stays the faster choice for a quick lookup.
What it is
A search server backed by xAI's Grok API, with separate tools for the web, news and Twitter/X, and a basic or comprehensive analysis mode on each.
What you get
- grok_search — web, news or general search, chosen per query, with up to 20 results and a from/to date range
- grok_web_search and grok_news_search — the same search held to web pages or to recent news
- grok_twitter — Twitter/X posts, optionally limited to a list of handles
- Comprehensive mode on any search: key findings with confidence, a timeline and direct quotes, rather than a plain result list
- health_check — server health and API connectivity
Requirements
An xAI API key in XAI_API_KEY.
Setup effort
Build from source — git clone https://github.com/stat-guy/grok-search-mcp.git
USE CASES
01
Getting the gist of a Twitter/X discussion without scrolling every post
Search Twitter/X for the topic, optionally limited to the handles you trust, and ask for comprehensive analysis to get the key points and quotes rather than a list of posts.
5 tools
Listed in project docs. Your client may show a different list.
grok_web_searchgrok_news_searchgrok_twitterhealth_checkBEFORE YOU INSTALL
What to know first
Tools you get
5 tools named in the project's documentation.
Requires
- Node.js and npm
- XAI_API_KEY in your environment
Where it runs
The documented client runs the server on your machine.
INSTALLATION
Connect your client
This one is built from source rather than installed with a single command.
Server setup
TERMINAL
git clone https://github.com/stat-guy/grok-search-mcp.git
cd grok-search-mcp
npm install -g .
export XAI_API_KEY="<YOUR_XAI_API_KEY>"Or put XAI_API_KEY=<YOUR_XAI_API_KEY> in a .env file.
Add the mcpServers block to ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%/Claude/claude_desktop_config.json (Windows)
MCP Clients
Claude Desktop
CLAUDE DESKTOP · JSON
{
"mcpServers": {
"grok-search": {
"command": "grok-search-mcp",
"env": {
"XAI_API_KEY": "<YOUR_XAI_API_KEY>"
}
}
}
}npm install -g . puts this repository's grok-search-mcp command on your PATH. The README's own block runs npx grok-search-mcp instead, which downloads a different npm package of the same name (lie5860/grok-search-npm) with different tools.
