Skip to main content
Glama
yukincom

Grok-MCP-Claude

by yukincom
OverviewSchemaSourceRelated ServersDiscussionsAdmin
Python
Remote

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

Related MCP server: openai-agents-mcp

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

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

This server cannot be deployed

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Maintenance

ActivityInactive
ResponsivenessNo issues

Resources

Related MCP Connectors

Related MCP Servers

  • computer-use-mcp

    domdomegg
    A
    license
    Not graded
    quality
    A
    maintenance
    MCP server that enables Claude to control your computer, similar to Anthropic's computer use but easy to set up locally.
    2,577 npm
    388
    MIT

  • MCP Web Server

    zhaiy
    F
    license
    D
    quality
    D
    maintenance
    A local MCP server providing free network access capabilities including HTTP requests, web search, webpage content extraction, and optional screenshots, designed for integration with Claude Desktop or Claude Code.
    6
    -

  • gemini-research-mcp

    Esanii
    F
    license
    Not graded
    quality
    D
    maintenance
    An MCP server that adds real-time web research to Claude Desktop using Gemini 2.5 Flash with native Google Search grounding.
    -