# x.ai Grok MCP Server

Model Context Protocol (MCP) server for interacting with x.ai Grok API.

## Features

- Chat completions via x.ai Grok API
- Support for multiple Grok models (grok-beta, grok-2-latest, grok-4-latest)
- System and user message support
- Configurable temperature and max tokens
- Secure API key management via 1Password CLI

## Installation

### Via npm

```bash
npx -y mcp-server-xai-grok
```

### Local Development

```bash
git clone https://github.com/darkangelpraha/xai-grok-mcp-server.git
cd xai-grok-mcp-server
npm install
npm run build
npm start
```

## Configuration

### Claude Desktop

Add to `~/Library/Application Support/Claude/claude_desktop_config.json`:

```json
{
  "mcpServers": {
    "xai-grok": {
      "command": "/usr/local/bin/npx",
      "args": ["-y", "mcp-server-xai-grok"],
      "env": {
        "XAI_API_KEY": "op://AI/API Credentials | Grok Business/API KEY"
      },
      "description": "x.ai Grok API MCP server for chat completions"
    }
  }
}
```

### Environment Variables

- `XAI_API_KEY` (required): Your x.ai API key. Use 1Password CLI reference: `op://AI/API Credentials | Grok Business/API KEY`

## Usage

### Available Tools

#### `chat_completion`

Send a chat completion request to x.ai Grok API.

**Parameters:**
- `messages` (required): Array of chat messages with `role` and `content`
- `model` (optional): Model to use (`grok-beta`, `grok-2-latest`, `grok-4-latest`). Default: `grok-4-latest`
- `temperature` (optional): Sampling temperature (0-2). Default: 1.0
- `max_tokens` (optional): Maximum tokens to generate

**Example:**

```json
{
  "messages": [
    {
      "role": "system",
      "content": "You are a helpful assistant."
    },
    {
      "role": "user",
      "content": "Hello, how are you?"
    }
  ],
  "model": "grok-4-latest",
  "temperature": 0.7
}
```

## Testing

### With MCP Inspector

```bash
npx -y @modelcontextprotocol/inspector npx -y mcp-server-xai-grok
```

### Local Testing

```bash
# Set API key
export XAI_API_KEY="your-api-key-here"

# Run server
npm run dev
```

## Requirements

- Node.js 20.0.0 or higher
- x.ai API key with credits/licenses

## License

MIT

## Author

darkangelpraha

## Repository

https://github.com/darkangelpraha/xai-grok-mcp-server