How do I use grok-mcp?

1. Click on "Install Server". 2. Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state. 3. In the chat, type @ followed by the MCP server name and your instructions, e.g., "@grok-mcp what are the latest trends in AI research? use web search" That's it! The server will respond to your query, and you can continue using it as needed. Here is a step-by-step guide with screenshots.

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"
      }
    }
  }
}

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

C

maintenance

How are these scores calculated?

Resources

Need Help?

Related Servers

Unclaimed servers have limited discoverability.

Looking for Admin?

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

grok-mcp

grok-mcp

Quick Start

Alternative: project config

Tools

`ask_grok`

`check_files`

File syntax

Safety limits

Available models

Examples

License

Resources

Looking for Admin?

Tools

Latest Blog Posts

MCP directory API