How do I install Grok2api?

Copy the stdio config for Cursor, Claude Desktop, Claude Code, or VS Code on this page. It uses the publisher's install, not a PlugMCP proxy.

Does Grok2api need an API key?

No required environment variable is listed on this record.

What transport does Grok2api use?

Grok2api runs locally over stdio.

When was Grok2api last checked?

Last checked 2026-10-28. MCP server for real-time web search via Grok — structured results with sources, confidence scores, and multi-language support

Grok2api MCP 서버

에이전트 강화

이 서버 추가

Install from the publisher. Not a PlugMCP endpoint.

PlugMCP에서 실행

Host a copy with our keys and logs.

No packaged release in the registry yet. Follow the repository README.

RepositoryPublisher installStep-by-step: add this in Claude

Remote URL or a command on your machine? How the two installs differ

PlugMCP에서 실행

Host a copy with our keys and logs.

A new server you create. It is not this listing's official endpoint. Use the publisher install when you want their URL and their credentials.

실행

Server facts

Local

Transport: stdio
License: MIT
Last checked: 2026-10-28

Tools

No tool list yet. Remote servers get one after the first health check.

FAQ

Questions

Grok2API MCP Server

English · 中文

An MCP (Model Context Protocol) server that provides real-time web search via Grok. Returns structured results with source URLs, confidence scores, key points, and multi-language support.

How It Works

Claude / Cursor / etc.  ──MCP──>  grok-mcp-server  ──HTTP──>  grok2api  ──>  Grok

This server bridges MCP clients to a grok2api-compatible backend, exposing Grok's real-time web search through an OpenAI-compatible API.

Features

Real-time web & Twitter/X search via Grok
Structured JSON output — summary, key points with citations, source list, confidence score
Multiple output modes — brief, analyst, raw
Multi-language support — respond in any language
Time range filtering — 24h, 7d, 30d, all
Source freshness control — prefer recent sources
Domain allowlist preference — prioritize trusted domains (best-effort)
Automatic retries with exponential backoff
Runtime metrics via grok_stats tool

Prerequisites

You need a running grok2api instance (or any OpenAI-compatible API endpoint backed by a Grok model with web search).

Setting Up the grok2api Backend

It is strongly recommended to use a secondary/alt Grok account for this, not your primary account.

1. Deploy grok2api

Choose the method that fits your environment:

Requires Docker and Docker Compose installed on your server.

git clone https://github.com/chenyme/grok2api
cd grok2api
docker compose up -d

The admin panel will be available at http://your-server-ip:8000/admin (default password: grok2api).

Requires Python 3.11+ and uv.

# Install uv if you don't have it
brew install uv

# Clone and run
git clone https://github.com/chenyme/grok2api
cd grok2api
uv sync
uv run main.py

The admin panel will be at http://localhost:8000/admin (default password: grok2api).

Requires Python 3.11+ and uv.

# Install uv (PowerShell)
powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

# Clone and run
git clone https://github.com/chenyme/grok2api
cd grok2api
uv sync
uv run main.py

The admin panel will be at http://localhost:8000/admin (default password: grok2api).

Requires Python 3.11+ and uv.

# Install uv
curl -LsSf https://astral.sh/uv/install.sh | sh

# Clone and run
git clone https://github.com/chenyme/grok2api
cd grok2api
uv sync
uv run main.py

The admin panel will be at http://localhost:8000/admin (default password: grok2api).

For cloud deployments (Vercel, Render), see the grok2api README.

2. Get Your Grok Cookie

Log into grok.com with your Grok account
Open browser DevTools (F12 or Cmd+Opt+I)
Go to the Application tab
In the left sidebar, expand Storage → Cookies
Find the cookie named sso or sso-rw
Copy its value

3. Add Token to grok2api

Open the grok2api admin panel (http://your-server:8000/admin)
Click Add to add a new token
Paste the cookie value you just copied
Select your account type based on your Grok subscription:
- Basic — 80 requests per 20 hours
- Super — 140 requests per 2 hours

The GROK_API_KEY in your .env is the admin key configured in grok2api (the app.app_key value, default: grok2api).

Installation

Option A: Global install (recommended)

git clone https://github.com/wousp112/grok2api-mcp-server.git
cd grok-mcp-server
cp .env.example .env
# Edit .env with your API URL and key
npm install
npm link

Option B: Local install

git clone https://github.com/wousp112/grok2api-mcp-server.git
cd grok-mcp-server
cp .env.example .env
# Edit .env with your API URL and key
npm install

Configuration

Copy .env.example to .env and fill in your values:

Variable	Required	Default	Description
`GROK_API_URL`	Yes	—	Your grok2api endpoint (e.g. `http://your-server:8000/v1`)
`GROK_API_KEY`	Yes	—	API key for authentication
`GROK_MODEL`	No	`grok-3`	Grok model name
`GROK_REQUEST_TIMEOUT_MS`	No	`60000`	Request timeout (ms)
`GROK_MAX_RETRIES`	No	`2`	Max retry attempts
`GROK_BACKOFF_BASE_MS`	No	`800`	Base backoff delay for retries (ms)
`GROK_READ_TIMEOUT_MS`	No	Same as request timeout	Axios timeout (ms)

MCP Client Configuration

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

{
  "mcpServers": {
    "grok-search": {
      "command": "grok-mcp-server",
      "args": [],
      "env": {
        "PATH": "/usr/local/bin:/usr/bin:/bin"
      }
    }
  }
}

{
  "mcpServers": {
    "grok-search": {
      "command": "grok-mcp-server",
      "args": []
    }
  }
}

Add to .cursor/mcp.json:

{
  "mcpServers": {
    "grok-search": {
      "command": "grok-mcp-server",
      "args": []
    }
  }
}

Note: If you skipped npm link, use the full path instead: "command": "/path/to/grok-mcp-server/index.js"

Tools

`grok_web_search`

Search the web or Twitter/X via Grok with structured output.

Parameter	Type	Required	Default	Description
`query`	string	Yes	—	The question or topic to search for
`output_mode`	`brief`\|`analyst`\|`raw`	No	`analyst`	Response detail level
`language`	string	No	`en`	Response language code
`time_range`	`24h`\|`7d`\|`30d`\|`all`	No	`all`	Search lookback window
`freshness_days`	integer	No	—	Prefer sources within N days
`max_sources`	integer	No	`8`	Max sources in output (1–20)
`domains_allowlist`	string[]	No	—	Preferred source domains, best-effort (max 30)

Response structure:

{
  "summary": "Concise factual summary",
  "key_points": [
    { "point": "Key finding", "source_urls": ["https://..."] }
  ],
  "sources": [
    {
      "title": "Article Title",
      "url": "https://...",
      "publisher": "Publisher Name",
      "published_at": "2025-01-01T00:00:00Z",
      "relevance_note": "Why this source matters"
    }
  ],
  "confidence": 0.85,
  "as_of": "2025-01-01T12:00:00Z",
  "notes": "Additional context or caveats"
}

`grok_stats`

Returns runtime metrics: call counts, error distribution, uptime.

Acknowledgements

grok2api by chenyme — the backend that makes Grok accessible via OpenAI-compatible API

License

MIT

이 서버 추가

Host a copy with our keys and logs.

Server facts

Tools

Questions

How do I install Grok2api?

Does Grok2api need an API key?

What transport does Grok2api use?

When was Grok2api last checked?

Documentation

Grok2API MCP Server

How It Works

Features

Prerequisites

Setting Up the grok2api Backend

1. Deploy grok2api

2. Get Your Grok Cookie

3. Add Token to grok2api

Installation

Configuration

MCP Client Configuration

Tools

grok_web_search

grok_stats

Acknowledgements

License

`grok_web_search`

`grok_stats`