Grok MCP

🚀 Grok MCP Server

Leverage xAI's Grok API to conduct real - time searches on X.com directly from Claude.

A Model Context Protocol server that enables real - time X/Twitter search for Claude. Powered by xAI's Live Search API, it offers instant access to posts, users, threads, and trending topics.

✨ Features

• Real - time data: Access live X.com content, not cached or outdated information.
• Native Claude integration: Works seamlessly with Claude Desktop and Claude Code.
• Simple setup: One command to install, one config to add.
• Open source: MIT licensed, community - driven.

🚀 Quick Start

1. Get an xAI API Key

Obtain your API key from console.x.ai.

2. Install

uvx grok-mcp

3. Configure Claude

For Claude Code: Add the following to .mcp.json in your project:

{
  "mcpServers": {
    "grok": {
      "command": "uvx",
      "args": ["grok-mcp"],
      "env": {
        "XAI_API_KEY": "your-api-key"
      }
    }
  }
}

For Claude Desktop: Add to your config file:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "grok": {
      "command": "uvx",
      "args": ["grok-mcp"],
      "env": {
        "XAI_API_KEY": "your-api-key"
      }
    }
  }
}

4. Use It

Ask Claude questions like:

• "Search X for posts about AI"
• "What's trending on X right now?"
• "Find tweets from @elonmusk about Tesla"

💻 Usage Examples

Search Posts

Search X for posts about "AI safety" from the last week

Filter by User

Find recent posts from @anthropic about Claude

Get Trends

What are the trending topics in tech right now?

📦 Installation

# Clone
git clone https://github.com/guzus/grok-mcp.git
cd grok-mcp

# Install dependencies
uv sync --dev

# Run tests
uv run pytest

# Run locally
XAI_API_KEY=your-key uv run python -m grok_mcp

🔧 Technical Details

src/grok_mcp/
├── server.py           # MCP server implementation
├── grok_client.py      # xAI Live Search API client
├── search_tools.py     # Tool implementations
├── response_formatter.py
├── config.py
└── exceptions.py

🤝 Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

1. Fork the repository.
2. Create your feature branch (git checkout -b feature/amazing-feature).
3. Commit your changes (git commit -m 'Add amazing feature').
4. Push to the branch (git push origin feature/amazing-feature).
5. Open a Pull Request.

📄 License

This project is under the MIT License. See LICENSE for details.

🔗 Links

• PyPI Package
• xAI API Docs
• MCP Protocol
• Claude Code

Built with xAI Grok and Model Context Protocol