grok-mcp
grok-mcp
MCP-Server, der die xAI Grok-API umschließt. Ermöglicht es Claude und anderen KI-Agenten, Denk-, Planungs- und Echtzeit-Suchaufgaben an Grok zu delegieren.
Schnellstart
Einzeiler zum Hinzufügen zu Claude Code auf jedem Gerät:
claude mcp add grok -e XAI_API_KEY=your-key -- npx -y @pkwadsy/grok-mcpSie benötigen einen xAI-API-Schlüssel von console.x.ai.
Alternative: Projektkonfiguration
Hinzufügen zur .mcp.json Ihres Projekts:
{
"mcpServers": {
"grok": {
"type": "stdio",
"command": "npx",
"args": ["-y", "@pkwadsy/grok-mcp"],
"env": {
"XAI_API_KEY": "your-xai-api-key"
}
}
}
}Related MCP server: grok-search-mcp
Tools
ask_grok
Stellen Sie Grok eine Frage mit optionalem Dateikontext, Websuche und X/Twitter-Suche.
Parameter | Typ | Erforderlich | Beschreibung |
| string | ja | Die Frage oder Aufgabe für Grok |
| string[] | nein | Dateien, die in den Kontext einbezogen werden sollen (siehe Dateisyntax unten) |
| number | nein | Maximale Anzahl an Dateien überschreiben (Standard 50) |
| number | nein | Maximale Größe pro Datei in KB überschreiben (Standard 32) |
| string | nein | Benutzerdefinierter System-Prompt |
| string | nein | Zu verwendendes Modell (Standard: |
| boolean | nein | Websuche, standardmäßig aktiviert |
| boolean | nein | X/Twitter-Suche aktivieren |
check_files
Testlauf der Datei-Auflösung. Überprüft alle Dateien und zeigt die Größen an, ohne Grok aufzurufen. Wenn check_files erfolgreich ist, wird ask_grok ebenfalls erfolgreich sein.
Parameter | Typ | Erforderlich | Beschreibung |
| string[] | ja | Zu prüfende Dateien (gleiche Syntax wie |
| number | nein | Maximale Anzahl an Dateien überschreiben (Standard 50) |
| number | nein | Maximale Größe pro Datei in KB überschreiben (Standard 32) |
Dateisyntax
Dateien werden als Array von Strings mit kompakter Syntax übergeben:
Syntax | Beschreibung |
| Ganze Datei |
| Zeilen 10 bis 30 |
| Nur Zeile 10 |
| Glob-Muster |
| Größenbeschränkung pro Datei umgehen |
| Zeilenbereich mit Force kombinieren |
Sicherheitslimits
Limit | Standard | Überschreiben |
Dateien pro Aufruf | 50 |
|
Größe pro Datei | 32 KB |
|
Gesamter Kontext | 256 KB | Hartes Limit, nicht überschreibbar |
Verfügbare Modelle
grok-4.20-multi-agent— Multi-Agenten-Modus, hervorragend für Architektur und Planung (Standard)grok-4.20-reasoning— Flaggschiff-Reasoninggrok-4.20-non-reasoning— schnell, kein Reasoninggrok-4.1-fast-reasoning— günstigeres Reasoninggrok-4.1-fast-non-reasoning— am günstigsten, schnell
Beispiele
Frage mit Dateikontext:
prompt: "Review this code for bugs"
files: ["src/index.ts", "src/utils.ts:20-50"]Websuche:
prompt: "What happened in tech news today?"X/Twitter-Suche:
prompt: "What are people saying about the new React release?"
x_search: trueDateien vor dem Fragen prüfen:
files: ["src/**/*.ts"]Lizenz
MIT
Available Tools
2 toolsask_grokA
Ask Grok a question. Grok is great for thinking, planning, architecture, and real-time search via web and X/Twitter. Use web_search for current information from the internet. Use x_search to find and analyze posts on X/Twitter. IMPORTANT: Grok has no context about your conversation or codebase. Always include all relevant context directly in the prompt — file contents, error messages, architecture details, constraints, and goals. The more context you provide, the better Grok's response will be. Do not assume Grok knows anything about the current project. Use the files parameter to automatically include file contents with line numbers — this is preferred over pasting code into the prompt. File paths are resolved relative to the server working directory: /app. Responses include a response_id — pass it back as previous_response_id to continue a conversation without resending context.
Inputs: prompt (required), previous_response_id, files, max_files, +5 more.
check_filesA
Dry-run file resolution. Use this before ask_grok to verify files will resolve correctly and check context size. Uses the same validation as ask_grok — if check_files passes, ask_grok will too. File paths resolve relative to: /app
Inputs: files (required), max_files, max_file_size.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 2 tools
ask_grok and check_files serve clearly distinct purposes: one is for querying Grok, the other is a dry-run validator for file resolution. No overlap or ambiguity.
Both tool names follow a consistent verb_noun pattern (ask_grok, check_files), using underscores and clear verbs.
Only 2 tools feels thin for a server that provides access to Grok, which could benefit from additional tools for conversation management or specialized searches.
The tool set lacks basic conversational features like retrieving history or managing context, and the promised web_search/x_search capabilities are not exposed as separate tools, limiting functionality.
Maintenance
Related MCP Connectors
Hosted X (Twitter) MCP server for Claude, ChatGPT and Cursor, with each action switched per account.
Hosted MCP server from TwitterAPI.io that gives AI agents read-only access to Twitter/X data. 12 tools: tweet search with X operators, user profiles, a user's latest tweets, followers and followings, replies, quotes, retweeters, mentions and trends. Connect at https://mcp.twitterapi.io/mcp with a TwitterAPI.io API key or account sign-in; usage is paid per result returned. Separately, TwitterAPI.io also offers x402 pay-per-call HTTP endpoints (tweet search, user info, a user's latest tweets) paid in USDC on Base or Solana with no account or API key; see https://docs.twitterapi.io/x402-pay-per-call. The MCP server itself uses an API key or sign-in.
MCP server for your apps' tools and custom tools, plus hosted AI agents and approval-gated workflows
MCP server for progressive tool usage at any scale (see https://klavis.ai)
Related MCP Servers
- AlicenseAqualityBmaintenanceUse XAI's latest api functionalities with Grok MCP. It supports image understanding and generation, live search, latest models and more.2255MIT
- AlicenseNot gradedqualityDmaintenanceMCP server that enables coding agents to search X/Twitter and the web through the local Grok CLI, providing better search results than default Codex or Claude search without requiring an API key.7MIT
- AlicenseNot gradedqualityCmaintenanceMCP server for xAI Grok API with 19 tools for chat, web and X search, session management, tool chaining, image and video generation, and documentation.2MIT
- AlicenseNot gradedqualityDmaintenanceA 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.MIT