Grok Build + Cuiar

Find the missing labels, then fix them.

  • grok mcp add
  • ~/.grok/config.toml
  • Reads .mcp.json too

Grok Build reads your repo in the terminal. With Cuiar it also reads the running page. It opens staging in a clean QA workspace and takes a snapshot of the accessibility tree.

It finds inputs with no label and images with no alt text, fixes them in src/ and checks the page again, in the same session.

A staging page with outlines on its parts. Red tags appear on the problems: an input with no label, an image with no alt text, a skipped heading. Then each tag turns green with a check, and the terminal line reads 7 fixed.

Setup

Add the server to Grok Build.

Grok Build runs on your computer, next to the Cuiar app.

  1. 1

    Install Grok Build

    Skip this when it is installed.

    curl -fsSL https://x.ai/cli/install.sh | bash
  2. 2

    Add the server

    grok mcp add --transport http cuiar https://mcp.cuiar.com/mcp
  3. 3

    Or write config.toml

    Use .grok/config.toml with --scope project to share it with the team.

    ~/.grok/config.toml
    [mcp_servers.cuiar]
    url = "https://mcp.cuiar.com/mcp"
  4. 4

    Sign in

    The first call opens the cuiar.com sign-in. In the TUI, /mcps opens the MCP tab. grok mcp doctor cuiar checks the server.

Other ways to connect

  • An API key

    For CI and shared machines. Use a key with the mcp scope.

    grok mcp add --transport http cuiar https://mcp.cuiar.com/mcp \
      --header "Authorization: Bearer ${CUIAR_API_KEY}"
  • Local stdio

    Needs the Cuiar CLI, signed in.

    grok mcp add cuiar -- cuiar mcp
  • Set up for Claude Code or Cursor already?

    Grok Build reads .mcp.json, .cursor/mcp.json and ~/.claude.json. A cuiar entry there works with no new step.

Route

The snapshot is the audit.

snapshot returns the accessibility tree with element refs. That is the data an accessibility pass needs, and Grok Build gets it as a tool result next to the code.

Remote MCPmcp.cuiar.com/mcp
Best fit
OAuth on first use, or a key header.
Local MCPcuiar mcp
Works
grok mcp add cuiar -- cuiar mcp.
CLIcuiar exec
Works
The bash tool runs cuiar exec --json and reads the exit code.
Routineson a schedule
Works
Grok Build has no scheduler. Use a Cuiar routine for nightly checks, or grok -p in CI.

Example tasks

QA passes on staging

  • 01

    Run an accessibility pass

    “Open staging.example.com in my QA workspace. For home, pricing, sign-up, login, checkout and account, take a snapshot and list inputs with no label, buttons with no name, images with no alt text and skipped heading levels. Fix them in src/ and check again.”

  • 02

    Buy in the payment sandbox

    cuiar run --workspace qa-checkout --folder ./qa/screens \
      "Sign in to staging with the saved test account. Buy the Pro yearly plan with the Stripe test card 4242 4242 4242 4242. Check the receipt page and the Paid badge in /admin, and save a screenshot of each step."
  • 03

    Find cookies set before consent

    “Make a new workspace for each run, one with staging.example.com/?geo=de and one with ?geo=us. Before any click, read document.cookie with evaluate and list the cookies set before consent. Check that Reject all is on the first layer for the EU.”

  • 04

    Follow a reset mail

    “Request a password reset for qa@example.com. Open the Mailpit inbox on staging, click the link in the mail and check that it opens the reset form on staging.”

  • 05

    Check it each night

    cuiar routines create "Nightly reset" --schedule "0 2 * * 1-5" --time-zone Europe/Berlin \
      --workspace qa-reset --webhook https://ci.example.com/hooks/cuiar \
      "Request a password reset on staging for the test account, open the reset link from the staging mail viewer, set a new password and report each step that fails."

    The result comes by email, and a signed webhook goes to CI.

Good to know

Permission modes
Grok Build asks by default. In auto mode a classifier approves safe tools. Deny rules always win.
Access
Grok Build is an early beta for SuperGrok and X Premium Plus subscribers.
Headless
grok -p "..." --output-format json runs it from CI.

Templates to run from Grok Build

All templates

Each template page shows the run_task or create_routine call to give Grok Build.