v0.3.0

grok-mcp v0.3.0

Background-job lifecycle overhaul for research / x_search / ask_grok.

Added

• Queueing at the inflight cap. Jobs past the 10 concurrent slots now wait
  in a bounded queue (up to 20) and return a job_id immediately instead of
  being rejected. RATE_LIMITED (retryable) is returned only when the queue is
  full.
• Async offload by default. Omitting timeout_secs now offloads after a
  ~25s window instead of blocking until the client's request timeout fires.
  Fast calls still return inline; slower ones return status=running + job_id
  to poll. timeout_secs (1–300) still overrides the window.
• Queued vs running visibility. The deferred response reports status
queued (waiting for a slot) or running (executing), with a matching poll
  hint.
• Abandoned-job drop. A queued job with no job_status poll for ~5 minutes
  is dropped (status failed, code ABANDONED) when it reaches a slot, so a
  disconnected or exited client no longer burns SuperGrok quota on a result
  nobody will read.

Notes

• Running jobs are never aborted mid-flight (quota is already spent); only
  queued jobs are dropped.

Assets

Uploaded by CI after publish:

• grok-mcp-v0.3.0-x86_64-unknown-linux-gnu
• Windows best-effort

Upgrade

sudo ./deploy/grokctl update

v0.2.2

grok-mcp v0.2.2

Changed

• Inflight job cap raised 2 → 10. Parallel x_search / research /
  ask_grok bursts no longer hit RATE_LIMITED at the 3rd concurrent
  background job. Over the (now higher) cap still returns a retryable
  RATE_LIMITED.

Docs

• The concurrency cap and its retryable RATE_LIMITED response are now
  surfaced across the tool surface: the research / x_search / ask_grok
  descriptions, the x_search.timeout_secs field doc, the job_status
  description, and the server-level instructions.

Assets

Uploaded by CI after publish:

• grok-mcp-v0.2.2-x86_64-unknown-linux-gnu
• Windows best-effort

Upgrade

sudo ./deploy/grokctl update

v0.2.1

grok-mcp v0.2.1

Fix

• Zero-touch auth recovery when the SuperGrok refresh token is revoked/stale:
  • Single-flight refresh (no concurrent RT rotation races)
  • Seed mcp store from ~/.grok/auth.json when missing
  • Adopt a strictly fresher Grok CLI session automatically
  • On invalid_grant, re-import from Grok CLI and retry once before REAUTH_REQUIRED

Assets

Uploaded by CI after publish:

• grok-mcp-v0.2.1-x86_64-unknown-linux-gnu
• Windows best-effort

Upgrade

sudo ./deploy/grokctl update

v0.2.0

grok-mcp v0.2.0

Breaking tool-surface redesign (dev-stage API).

Contract (v2)

• Removed: verbosity / raw, reasoning_effort, max_results
• Added:
  • depth: quick | standard | deep
  • result: digest | evidence | both (live tools)
  • max_items (x_search)
  • debug → optional debug_payload
• Evidence mode: best-effort full X post text without host x.com fetch
• Empty evidence: ok: true + evidence_status: empty|partial|complete (not a hard error)
• Tool descriptions warn: not bit-perfect / not for legal-audit verbatim

Tools

• x_search — digest / evidence / both; fidelity, cost_hint
• research — citations + optional quote; same result/depth axes
• ask_grok — depth only, no live search

Docs

• docs/tool_spec.md v2
• ADR-0004 superseded by ADR-0008

Assets

Uploaded by CI after publish:

• grok-mcp-v0.2.0-x86_64-unknown-linux-gnu
• Windows best-effort

Upgrade

sudo ./deploy/grokctl update
# hosts must switch to depth/result params (verbosity no longer accepted)

v0.1.2

grok-mcp v0.1.2

Changes

• Server description/instructions: emphasize live X (x.com) search and current web/news
• Stronger host routing for X post investigation:
  • x_search description pushes hosts to call it for posts/tweets/x.com (do not skip for built-in search)
  • research defers X-only work to x_search
  • Server instructions include explicit X → x_search routing
• Tighten REAUTH guidance (drop over-strict “only on”)

Assets

Uploaded by CI after publish:

• grok-mcp-v0.1.2-x86_64-unknown-linux-gnu
• Windows best-effort

Upgrade

sudo ./deploy/grokctl update
# or install binary from this release

v0.1.1

grok-mcp v0.1.1

Changes

• Expose xAI tool/usage metrics on research / ask_grok / x_search:
  • server_side_tool_usage, output_tool_call_counts
  • num_server_side_tools_used, num_sources_used, cached_tokens, total_tokens
• Structured journal log (grok_client::usage) for verifying input_tokens and search volume without response bodies

Assets

Uploaded by CI after publish:

• grok-mcp-v0.1.1-x86_64-unknown-linux-gnu
• Windows best-effort

Upgrade

sudo ./deploy/grokctl update
# or install binary from this release

v0.1.0

grok-mcp v0.1.0

Initial public release.

Features

• SuperGrok OAuth: auth import / device-code auth login + refresh
• Tools: ask_grok, x_search, research, job_status, auth_status
• Optional timeout_secs with background job polling
• Transports: stdio and Streamable HTTP (/mcp) with optional OAuth front-door
• Deploy helpers: deploy/grokctl (systemd + cloudflared)

Assets

Binaries are attached by the release workflow after this release is published:

• grok-mcp-v0.1.0-x86_64-unknown-linux-gnu (primary)
• grok-mcp-v0.1.0-x86_64-pc-windows-msvc.exe (best-effort)

Install (Linux)

# after assets appear
chmod +x grok-mcp-v0.1.0-x86_64-unknown-linux-gnu
sudo install -m 0755 grok-mcp-v0.1.0-x86_64-unknown-linux-gnu /usr/local/bin/grok-mcp
grok-mcp auth import   # or: auth login