> ## Documentation Index
> Fetch the complete documentation index at: https://darwin.so/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Grok Build

> Connect the Grok Build coding agent to Darwin Search and Act over remote MCP.

Add Darwin as a remote HTTP MCP server. Grok Build handles the OAuth browser flow and makes Darwin's tools available alongside its built-in coding tools.

```bash theme={null}
grok mcp add --transport http darwin https://mcp.darwin.so/mcp
```

Use [xAI's MCP server guide](https://docs.x.ai/build/features/mcp-servers) for current client behavior and configuration scopes.

## Verify the connection

```bash theme={null}
grok mcp doctor darwin
grok mcp list
```

Open `/mcps` in the Grok Build TUI if you need to authenticate, refresh the tool list, or disable the server. A successful connection exposes one Search tool and six Action tools under the `darwin` namespace.

<Note>
  Direct MCP installation works now. Darwin's public Grok Build plugin is prepared separately, but its xAI marketplace
  pull request has not been submitted for code-owner review.
</Note>

## Choose the right scope

| Scope   | Use it for                                                        |
| ------- | ----------------------------------------------------------------- |
| User    | Your personal Darwin connection across local projects.            |
| Project | A shared `.grok/config.toml` entry without committed credentials. |
| Managed | Organization policy that controls approved MCP servers.           |

Keep OAuth credentials in Grok Build's credential store. Never commit tokens, authorization headers, or Darwin API keys to `.grok/config.toml`.

## Preserve Darwin's authority boundary

Repository access and Grok Build permissions do not grant Darwin approval authority. Use Search to compare capabilities, preserve the exact selected revision, and let Darwin's current `availableActions` determine what can happen next.

<Warning>
  A model-authored message is not an approval, payment, authentication result, or completed Action. Read the current
  Action state before every consequential next step.
</Warning>

[View the installable plugin source](https://github.com/darwin-studios/darwin-grok-build-plugin) or xAI's [marketplace contribution rules](https://github.com/xai-org/plugin-marketplace/blob/main/CONTRIBUTING.md).