pmind-grok-mcp

piotrkandziora/pmind-grok-mcp

3.2

If you are the rightful owner of pmind-grok-mcp and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to henry@mcphub.com.

PMIND Grok MCP Server is an experimental server providing a comprehensive interface for Grok AI's capabilities.

PMIND Grok MCP Server

⚠️ Experimental: This MCP server is in an experimental state and may have rough edges. Please report any issues you encounter.

A comprehensive MCP (Model Context Protocol) server for Grok AI, providing access to chat, reasoning, live search, image understanding, and image generation capabilities through a clean, modular interface.

Features

  • 🤖 Chat Completions - Basic and history-managed conversations with Grok models
  • 🧠 Reasoning - Step-by-step problem solving with access to thinking traces
  • 🔍 Live Search - Real-time data from web, X (Twitter), news, and RSS feeds
  • 👁️ Image Understanding - Analyze images with custom prompts
  • 🎨 Image Generation - Create images from text descriptions

Prerequisites

Installation

# Clone the repository
git clone https://github.com/yourusername/pmind-grok-mcp.git
cd pmind-grok-mcp

# Install dependencies with uv
uv sync

Configuration

  1. Copy the example environment file:
cp .env.example .env
  1. Edit .env with your settings:
# Required
XAI_API_KEY=your_api_key_here

# Optional
GROK_MODEL=grok-4
GROK_TIMEOUT=3600
DOWNLOADS_DIR=downloads

Usage

Start the Server

uv run pmind-grok-mcp

The server will start and be available for MCP clients to connect.

Using with Claude Code

Use the following command to add the server:

claude mcp add pmind-grok-mcp -- uv run --directory /path/to/pmind-grok-mcp pmind-grok-mcp

Replace /path/to/pmind-grok-mcp with the actual path where you cloned the repository.

Available Tools

The server provides tools for chat completions, reasoning, live search, image understanding, and image generation. Each tool is accessible through the MCP protocol with comprehensive parameter documentation.

Troubleshooting

API Key Issues

Timeout Errors

  • Increase GROK_TIMEOUT for reasoning models (default: 3600s)
  • Reasoning models require longer processing time

Rate Limiting