One Grok gateway.
Every coding agent.

UniGrok lets Codex, Claude, VS Code, and other MCP clients share a server-side Grok connection without copying your xAI credential into every editor.

Explore the project Run it locally

01 One server-side credential boundary02 API and subscription CLI planes stay distinct03 Codex-owned integration and release gates

example · local command session

$ curl -fsS localhost:4765/healthz

✓ example response: {"status":"healthy"}

$ codex mcp get grok

transportStreamable HTTPendpointlocalhost:4765/mcptoolsagent + research jobscredentialserver-side only

# each client sends its own X-Client-ID

Published route contract · not a live runtime probe

PUBLIC PROJECT INFOStatic metadata available

CONTROL CENTERGitHub role-gated

REMOTE MCPPrivate review pending · public MCP deferred

One service, clear trust zones

Local power without making
your laptop the product.

The public site teaches the project. The protected control center is for approved contributors. UniGrok itself keeps credentials and model execution behind an MCP boundary.

Shared MCP gateway

Connect multiple IDE agents to one stable endpoint with per-client attribution and server-held credentials.

POST /mcp

Two execution planes

The xAI API plane and Grok CLI subscription plane have separate catalogs, sessions, costs, and failover rules.

api ≠ cli

Supervised collaboration

Agents and humans can propose changes while deterministic tests and Codex-owned landing keep main coherent.

review → verify → land

IDE agentsCodex · Claude · VS Code

UniGrok MCPRouting · sessions · policy

Grok planesxAI API · local CLI

Start with the real boundary

Run locally. Verify directly.
Then connect your IDE.

Initialization prints the supported xAI API and SuperGrok CLI credential paths. Complete at least one before expecting real agent calls to succeed.

git clone https://github.com/djtelicloud/grok-mcp-server.git
cd grok-mcp-server
uv run python main.py init
# Choose an API or CLI credential path; then:
docker compose up --build -d

Quick startInstall and start UniGrok ↗IDE setupConnect Codex and other clients ↗ArchitectureUnderstand planes and trust zones ↗

Built for people and agents

Public project context,
in machine-readable form.

/llms.txtConcise agent orientation →/.well-known/unigrok.jsonDiscovery contract →/api/public/v1/projectVersioned metadata →

Help build the gateway

Contributors get a control plane.
Visitors get a clear front door.

GitHub login establishes contributor identity. Every protected request performs a fresh server-side role check against this repository before returning project data.

Become a contributor View open issues

One Grok gateway.Every coding agent.

Local power without makingyour laptop the product.