MCP Servers

Grok-MCP-Claude

A single-file MCP server that enhances Claude Desktop with real-time web and X search, multi-tool agent, and image/video generation via xAI's Grok.

README

Grok-MCP-Claude

Grok MCP server optimized for Claude Desktop — clean, single-file implementation using xAI's Grok for real-time web/X search and image generation.

Concept

Claude thinks, Grok searches.

Claude Desktop handles conversation, memory, and reasoning. Grok provides what Claude can't — real-time web search, X (Twitter) search, and image/video generation.

sucsess

Features

Tool	Description
`grok_search`	Real-time web and X (Twitter) search
`grok_chat`	Chat with vision, file, and code execution support
`grok_agent`	Multi-tool agent combining search, code execution, files, and images
`generate_image`	Image generation with img2img support
`generate_video`	Video generation with img2video and video2video support
`manage_files`	Upload, list, retrieve, and delete files on xAI

Requirements

Python 3.10+
xAI API key
Claude Desktop

Installation

git clone https://github.com/yourname/grok-mcp-claude.git
cd grok-mcp-claude
pip install -r requirements.txt

Configuration

Add to your Claude Desktop config (claude_desktop_config.json):

{
  "mcpServers": {
    "grok": {
      "command": "python",
      "args": ["/path/to/grok-mcp-claude/grok.py"],
      "env": {
        "XAI_API_KEY": "your-api-key-here"
      }
    }
  }
}

Tool Reference

`grok_search`

Real-time search via web or X (Twitter).

Parameter	Default	Description
`prompt`	required	Search query
`platform`	`"web"`	`"web"` or `"x"`
`model`	`DEFAULT_SEARCH_MODEL`	Model to use
`allowed_targets`	`None`	Whitelist of domains (web) or handles (X)
`excluded_targets`	`None`	Blacklist of domains (web) or handles (X)
`from_date`	`None`	Start date `DD-MM-YYYY` (X only)
`to_date`	`None`	End date `DD-MM-YYYY` (X only)
`include_inline_citations`	`False`	Return inline citations

`grok_chat`

General-purpose chat with optional vision, file, and code execution.

Parameter	Default	Description
`prompt`	required	User message
`model`	`DEFAULT_CHAT_MODEL`	Model to use
`system_prompt`	`None`	System prompt
`file_ids`	`None`	xAI file IDs to attach
`image_paths`	`None`	Local image paths
`image_urls`	`None`	Image URLs
`response_id`	`None`	Previous response ID for stateful chat
`use_code_execution`	`False`	Enable code execution

`grok_agent`

Multi-tool agent. Combine web search, X search, code execution, files, and images freely.

Parameter	Default	Description
`prompt`	required	User message
`model`	`DEFAULT_SEARCH_MODEL`	Model to use
`use_web_search`	`False`	Enable web search
`use_x_search`	`False`	Enable X search
`use_code_execution`	`False`	Enable code execution
`allowed_targets`	`None`	Whitelist of domains or handles
`excluded_targets`	`None`	Blacklist of domains or handles
`file_ids`	`None`	xAI file IDs to attach
`image_paths`	`None`	Local image paths
`image_urls`	`None`	Image URLs
`system_prompt`	`None`	System prompt
`include_inline_citations`	`False`	Return inline citations
`max_turns`	`None`	Max search iterations

`generate_image`

Generate images. Pass image_path or image_url for img2img.

Parameter	Default	Description
`prompt`	required	Generation prompt
`model`	`DEFAULT_IMAGE_MODEL`	Model to use
`n`	`1`	Number of images
`image_path`	`None`	Local image for img2img
`image_url`	`None`	Image URL for img2img
`aspect_ratio`	`None`	e.g. `"16:9"`, `"1:1"`, `"9:16"`

`generate_video`

Generate videos from text, image, or video.

Parameter	Default	Description
`prompt`	required	Generation prompt
`model`	`DEFAULT_VIDEO_MODEL`	Model to use
`image_path` / `image_url`	`None`	Source image for img2video
`video_path` / `video_url`	`None`	Source video for video2video
`duration`	`None`	Duration in seconds
`aspect_ratio`	`None`	Aspect ratio
`resolution`	`None`	Resolution

`manage_files`

Manage files on xAI.

Action	Required params	Description
`upload`	`file_path`	Upload a file
`list`	—	List uploaded files
`get_info`	`file_id`	Get file metadata
`get_content`	`file_id`	Get file content
`delete`	`file_id`	Delete a file

Models

DEFAULT_CHAT_MODEL   = "grok-4-1-fast-non-reasoning"
DEFAULT_SEARCH_MODEL = "grok-4-1-fast-reasoning"
DEFAULT_IMAGE_MODEL  = "grok-imagine-image"
DEFAULT_VIDEO_MODEL  = "grok-imagine-video"

License

MIT

Recommended Servers

playwright-mcp

A Model Context Protocol server that enables LLMs to interact with web pages through structured accessibility snapshots without requiring vision models or screenshots.

Official

Featured

TypeScript

Magic Component Platform (MCP)

An AI-powered tool that generates modern UI components from natural language descriptions, integrating with popular IDEs to streamline UI development workflow.

Audiense Insights MCP Server

Enables interaction with Audiense Insights accounts via the Model Context Protocol, facilitating the extraction and analysis of marketing insights and audience data including demographics, behavior, and influencer engagement.

VeyraX MCP

Single MCP tool to connect all your favorite tools: Gmail, Calendar and 40 more.

Official

Featured

Local

graphlit-mcp-server

The Model Context Protocol (MCP) Server enables integration between MCP clients and the Graphlit service. Ingest anything from Slack to Gmail to podcast feeds, in addition to web crawling, into a Graphlit project - and then retrieve relevant contents from the MCP client.

Official

Featured

TypeScript

Kagi MCP Server

An MCP server that integrates Kagi search capabilities with Claude AI, enabling Claude to perform real-time web searches when answering questions that require up-to-date information.

Official

Featured

Python

E2B

Using MCP to run code via e2b.

Official

Featured

Neon Database

MCP server for interacting with Neon Management API and databases

Official

Featured

Exa Search

A Model Context Protocol (MCP) server lets AI assistants like Claude use the Exa AI Search API for web searches. This setup allows AI models to get real-time web information in a safe and controlled way.

Official

Featured

Qdrant Server

This repository is an example of how to create a MCP server for Qdrant, a vector search engine.

Official

Featured