Guide
Grok Build drives a Foundry VTT game on the SuperGrok plan you already hold.
Grok Build is xAI's agent for the terminal, and it is the Grok that speaks MCP. Sign it in with your SuperGrok account, register Familiar with one command, and a check the CLI ships with proves the link before you type a word of play. Familiar sits at the Foundry end, switched on in the world you GM. SuperGrok pays for the AI: no key to buy, and no token meter running.
Which Grok this is
Grok Build runs in a terminal window, on Windows, Mac or Linux, and signs in with the account behind your SuperGrok subscription. That is the whole entry ticket. The plan you hold for the chat is the plan that drives your game, and the install is one line from xAI for your operating system, printed on the wizard card in Familiar's MCP tab.
The Grok app and grok.com sit this one out, for a mechanical reason rather than a policy. Their connectors accept a server on the public internet and nothing closer, and Familiar runs on the computer beside your Foundry window. Grok Build runs there too, which is why it can see it.
One command, then the doctor
With grok signed in, Familiar goes in with the line below, run in a terminal rather than inside Grok. Copy the finished version from the wizard card: it carries this world's real secret, and on Windows the command name and the antivirus setting the connect guide explains. Run it a second time and it replaces the entry instead of adding another.
Then the check the CLI ships with. grok mcp doctor familiar starts the server once and reports what it found, and a line reading handshake OK with a count of tools discovered means the link is real rather than merely written down. Keep the name on the end of that line; the snag list further down says what happens without it.
Rather not type it? The card also carries Copy setup prompt. Once Grok Build is installed and signed in, paste that prompt into grok itself and it registers Familiar for you, asking your approval as it goes.
grok mcp add familiar --env FAMILIAR_WS_SECRET=<your-secret> -- npx -y familiar-vtt
If another agent on this computer already runs Familiar
Grok Build reads the MCP servers, skills and hooks of the coding agents it knows how to read, Cursor among them, and it does so by default. Set Familiar up in one of those and it turns up inside Grok with no Grok-side step at all, next to every other server that agent holds.
The command above still wins for familiar. An entry in Grok's own config outranks an imported one of the same name, so running it never leaves you with two. What you may not want is the rest of the import, and the wizard card names the settings that keep the other agents' servers, skills and hooks out of Grok's list. The connect guide names the agents.
What a terminal changes at the table
Grok Build takes Familiar's full tool set from the first message. It reaches tools through a search layer of its own, so carrying every bundle costs it nothing up front, and there is no set to widen before a weather tool or a playlist tool will answer. Whatever you ask for happens in the Foundry tab in your browser: the scene switches, the token moves, the rain starts. What comes back to the terminal is a line saying so.
Pictures take a different path. A generated image, or the annotated screenshot of the live battlemap, comes back to Grok as something it reasons over, and whether your terminal draws it as well is the terminal's business; the image itself is already saved in your Foundry world.
The campaign is the one thing Grok Build does not bring. It plays the adventure you imported, page by page, from the journals, sheets and statblocks already in your world, and it fills in between those pages rather than writing new ones.
Combat & InitiativeScenes & TokensAudio & Playlists
- What stays in the Foundry windowWhat only the built-in chat can do, and why a terminal never sees it.
- Everything Familiar can doEvery bundle Grok Build can reach, listed by domain.
- How to play D&D with AIWhat a session looks like with a terminal on the other side of the table.
- Playing something other than D&D 5e?The systems with a page of their own, and what changes on each.
What to type once the doctor says OK
Type grok, start a conversation, and send the product's own line first, the one the wizard card closes on. If Grok answers with your world's name, everything under it is safe to try.
The four after it each lean on something this page has claimed: a combat bundle that was there from the first message, the scene and the weather on it, a sound that plays in Foundry while the terminal gets the receipt, and the clock.
- The verify line
Use Familiar's get-world-info tool
- Open a fight
Start combat with every token on the map and roll initiative for the monsters.
- Change the weather
Make it night on the current scene and start rain.
- Start the music
Play the playlist called <playlist name> in Foundry and tell me once it is running.
- Move the clock
Advance the in-game clock by eight hours and give the party a long rest.
Where only Grok Build trips
Every entry here comes from the terminal or from Grok's own habits, and none of them needs a reinstall. The failures every MCP client shares have one home, the connect guide, linked below.
grok is not recognised, seconds after the installer finished
The installer adds grok to your PATH, and only windows opened after it can see that. Close the window you installed from, open a new one, and type grok --version there; a version number means the install took. Sign in from that new window too.
grok mcp doctor familiar reports a startup timeout
The first start downloads the server, and Grok gives it half a minute by default. Open ~/.grok/config.toml, add startup_timeout_sec = 60 under the [mcp_servers.familiar] heading, and run the doctor again. Or get the download out of the way first: run npx -y familiar-vtt once in a terminal and let it stop on its complaint about the missing secret, which is the expected ending there.
The doctor started every server on the computer
The name was missing. grok mcp doctor on its own starts every server Grok can see, the imported ones included and even the ones you switched off, so a machine with other agents on it watches all of them spawn. End the line with familiar, every time.
grok mcp list shows familiar, but the add command had failed
The list is not the test. It also shows servers Grok imported from another agent's config, so familiar can sit there with no Grok entry behind it. Run the add command again, then the doctor with the name on the end; the handshake line is the proof.
You added Familiar as a custom connector on grok.com and it never connects
It cannot: that route needs a server the public internet can reach, and Familiar runs on your own machine. Grok Build is the way in, and it is the route this page describes.
You switched a tool bundle on mid-session and Grok cannot find the new tool
Grok Build does not act on a changed tool list, so a tool that arrives after the session started stays invisible to its search until the next one. Start grok again and ask once more. On this client the case is rare, since the full set is there from the start unless you narrowed it yourself.
Or meter it: an xAI key in Familiar's own chat
An xAI key is the other way in, and it needs no terminal at all. Put one in Familiar's settings and Grok answers from the Foundry tab, with xAI counting the tokens. Reasoning effort becomes a setting in Familiar on this route, and Grok's rungs run Low, Medium and High: nothing switches thinking off.
The plan and the key never meet. SuperGrok pays for the terminal, the key pays for the panel, and money put into one is invisible to the other. Familiar's subscription is billed on its own, whichever of the two you pick.
- The API key path, start to finishThe settings tab, the key field, and the first Grok model you pick there.
- Where the money goes on each routeSuperGrok against a metered key, and which suits how often your table plays.
- Model tiers, and the Thinking dialWhich Grok tier to point at, and what each rung of the dial buys.
More in Connect your assistant
Claude in Foundry: Desktop or Code
NewAnthropic builds both clients, so no agent app sits in the path. Desktop and Code differ in how you add each one, how many tools each carries, and whether a fetched picture ever reaches your screen.
ChatGPT in Foundry via Codex
NewThe Chat tab is not the piece that connects. The Codex tab in the ChatGPT app is, on every plan including Free, and so is Codex CLI from Plus upward: OpenAI's own agent either way. Both read the same config file.
Gemini in Foundry via Antigravity
NewAntigravity is Google's agent, and it is what reaches your Foundry game. Any Google account gets you in, including a free one. Or skip the agent altogether: a Google API key, pasted into Familiar's own chat window.
MCP vs API: which to choose
NewSubscription or API key? MCP subscription versus a pay-per-token key, and which is cheaper for how your table actually plays.
Choosing an AI model
NewWhich model, and how hard should it think? A capable model with reasoning headroom is the second lever behind good prep. Turn thinking up for fiddly rules, down to keep replies fast.
Running a local LLM
NewRun the model on your own PC instead of a provider, so your world never leaves the machine and the bill moves from a token meter to your graphics card. Setup is one settings tab and one switch. Without a discrete GPU, expect minutes per turn.
New to Familiar? I'm Ryan, the person who built it. The Discord is small and brand new, so if you join now I'll help you get set up myself.