grok-delegate
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| GROK_DELEGATE_JOBS_DIR | No | Optional directory for durable job artifacts. | |
| GROK_DELEGATE_LANES_PARENT | Yes | Parent directory for isolated git worktrees, outside the repo. | |
| GROK_DELEGATE_ALLOWED_ROOTS | Yes | Allowlisted project roots (fail-closed); empty allowlist rejects work. |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {} |
| prompts | {} |
| resources | {} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| grok_agent_economyA | Token-economy playbook for host agents: when to consult vs execute, how to poll compact receipts, and VPS offload tips. Call once; prefer over re-planning. Read-only, no secrets. |
| grok_agent_updateA | Update the bridge checkout from its git remote. Use after grok_agent_check_update reports a newer version. Without confirm it only reports steps; confirm=true pulls and reinstalls, then restart the host. Refuses a dirty checkout. |
| grok_agent_check_updateA | Compare the installed bridge with the latest GitHub release. Use when the user asks about updates or instructions show an update line. Read-only, cached 24 h. Returns current, latest, notes link, update command. |
| grok_agent_projectA | Read or set this project's Grok preset (.grok-mcp.json): off, cheap, standard, max. Use first when a job tool returns PROJECT_NOT_ENABLED. Without preset it reports; with preset it writes the file. |
| grok_agent_session_beginB | Session Protocol v1.2: begin session with plan compiler + budget guard. Pass intent, optional goal (≤500), host_budget tiny|small|normal. Returns mode, plan[≤5], budget, deny_tools, host_script, skill_ref. Call first. |
| grok_agent_session_tickC | Session Protocol v1.2: compact progress + budget. Returns step, steps_left, budget_remaining, force_end. Pass tool_used/step_done to count budget. verbose default false. |
| grok_agent_session_nextC | Session Protocol v1.2 navigator: ONE next action card (host_cmd|mcp_tool|end). Host loops this until done=true. |
| grok_agent_session_endC | Session Protocol v1.2: short receipt (status/job/changed/tests/next). Optional suggest_issue returns scrubbed issue draft (no auto-create). |
| grok_agent_statusB | Version/auth-presence, exact roots, transport router, daemon and durable job status. Read-only. |
| grok_agent_startC | Asynchronously start a versioned typed task packet on an explicit legacy|stdio|websocket transport. auto means stdio only. |
| grok_agent_pollB | Read bounded progress/events and the final evidence receipt for a typed job. |
| grok_agent_cancelC | Boundedly cancel one typed job without stopping the MCP server. |
| grok_agent_consultC | Start an isolated read-only consult session; non-git exact allowlisted roots are supported. |
| grok_agent_reviewC | Start an independent read-only skeptic session over supplied evidence/diff inputs. |
| grok_agent_executeC | Start workspace execution in a git worktree. completed requires a real diff and requested evidence. |
| grok_agent_fixC | Start a separate workspace fixer session scoped to confirmed findings in the task packet. |
| grok_delegateA | Delegate a coding goal to local headless grok in an isolated git worktree on a grok/* branch. Returns branch + diffstat. No push, no merge, no --always-approve. Dev-only — not the product admin-bridge. |
| grok_delegate_planA | Read-only plan variant of grok_delegate (plan_only=true). Does not allow write/edit/shell mutation in the permission profile. |
| grok_delegate_startA | Start grok_delegate in the BACKGROUND and return a job_id immediately. Use this instead of grok_delegate for real lanes: a lane runs for minutes and a synchronous call is killed by the client timeout, leaving an empty worktree. Poll with grok_delegate_poll. Same guarded profile, no push, no merge. |
| grok_delegate_pollA | Poll a job from grok_delegate_start. With job_id: state, result (branch, changed_files, commits, diffstat) and live phase/elapsed_s; early minutes in git with no worker are normal. Without job_id: newest jobs. Read-only. |
| grok_delegate_statusA | Report bridge health. Use before the first job or when a job fails to start: grok binary/version, auth presence (auth.json never read), git, allowed roots/lanes_parent, permission and sandbox profile. Read-only. |
| grok_delegate_doctorA | Run |
| grok_delegate_modelsB | List available models via |
| grok_delegate_inspectB | Run |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
| delegate_task | Run one coding goal through the session loop and report the verified receipt. |
| review_diff | Review a finished job's branch/diff read-only and list blocking findings. |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
| guide-index | Index of on-demand guides (session loop, fallback, verify, hosts, security). |
TDQS
Scored across 24 tools
Several tools share overlapping entry points for starting or managing Grok sessions (grok_delegate vs grok_delegate_start vs grok_agent_start/execute/review/fix/consult/plan), and status/poll pairs have similar scopes. Descriptions help distinguish intent, but an agent must parse carefully to avoid misselection.
All names use snake_case and follow predictable family prefixes (grok_agent_ and grok_delegate_), with consistent verb or noun patterns within each family. The two-prefix split is a minor deviation from a single convention but remains readable.
24 tools is heavy for a delegation bridge; while many variants (sync/async, session protocol, diagnostics, update) each have a role, the surface feels inflated. It sits near the upper bound of reasonable tool counts.
The set covers session lifecycle, job start/poll/cancel, status, diagnostics, update, and project preset configuration, giving strong lifecycle coverage. Only minor gaps like a unified job-list operation are apparent.