Skip to main content
Glama
deenesjakoruzh
PKWadsy

grok-mcp

by PKWadsy
OverviewSchemaRelated ServersScoreDiscussions
JavaScript
Remote

grok-mcp

MCP server that wraps the xAI Grok API. Lets Claude and other AI agents delegate thinking, planning, and real-time search to Grok.

Quick Start

One-liner to add to Claude Code on any device:

claude mcp add grok -e XAI_API_KEY=your-key -- npx -y @pkwadsy/grok-mcp

You need an xAI API key from console.x.ai.

Alternative: project config

Add to your project's .mcp.json:

{
  "mcpServers": {
    "grok": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@pkwadsy/grok-mcp"],
      "env": {
        "XAI_API_KEY": "your-xai-api-key"
      }
    }
  }
}

Related MCP server: x-ai-mcp

Tools

ask_grok

Ask Grok a question with optional file context, web search, and X/Twitter search.

Parameter

Type

Required

Description

prompt

string

yes

The question or task for Grok

files

string[]

no

Files to include in context (see file syntax below)

max_files

number

no

Override max file count (default 50)

max_file_size

number

no

Override max per-file size in KB (default 32)

system_prompt

string

no

Custom system prompt

model

string

no

Model to use (default: grok-4.20-multi-agent)

web_search

boolean

no

Web search, enabled by default

x_search

boolean

no

Enable X/Twitter search

check_files

Dry-run file resolution. Validates all files and shows sizes without calling Grok. If check_files passes, ask_grok will too.

Parameter

Type

Required

Description

files

string[]

yes

Files to check (same syntax as ask_grok)

max_files

number

no

Override max file count (default 50)

max_file_size

number

no

Override max per-file size in KB (default 32)

File syntax

Files are passed as an array of strings with compact syntax:

Syntax

Description

"src/index.ts"

Whole file

"src/index.ts:10-30"

Lines 10 to 30

"src/index.ts:10"

Just line 10

"src/**/*.ts"

Glob pattern

"large-file.ts:force"

Bypass per-file size limit

"large-file.ts:1-100:force"

Combine line range with force

Safety limits

Limit

Default

Override

Files per call

50

max_files param

Per-file size

32 KB

max_file_size param or :force suffix

Total context

256 KB

Hard cap, not overridable

Available models

  • grok-4.20-multi-agent — multi-agent mode, great for architecture and planning (default)

  • grok-4.20-reasoning — flagship reasoning

  • grok-4.20-non-reasoning — fast, no reasoning

  • grok-4.1-fast-reasoning — cheaper reasoning

  • grok-4.1-fast-non-reasoning — cheapest, fast

Examples

Ask with file context:

prompt: "Review this code for bugs"
files: ["src/index.ts", "src/utils.ts:20-50"]

Search the web:

prompt: "What happened in tech news today?"

Search X/Twitter:

prompt: "What are people saying about the new React release?"
x_search: true

Check files before asking:

files: ["src/**/*.ts"]

License

MIT

Install Server
A
license - permissive license
A
quality
D
maintenance

How are these scores calculated?

Maintenance

–Maintainers
–Response time
–Release cycle
–Releases (12mo)
Commit activity

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Tools

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/PKWadsy/grok-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server