Use SEOmatic in Grok Build

Connect Grok Build#

1. 1Install Grok Build if needed. Run curl -fsSL https://x.ai/cli/install.sh | bash and sign in to xAI.
2. 2Add the SEOmatic marketplace. Run: grok plugin marketplace add Minh42/seomatic-mcp
3. 3Install the plugin. Run: grok plugin install seomatic --trust. You can also open /marketplace inside Grok Build and install seomatic from there.
4. 4Sign in. Start grok in your project and ask a question about your site. Sign in or create a free SEOmatic account in the browser window that opens, then pick your site. If no window opens, open /mcps and press i on seomatic.
5. 5Ask your first question. Try “How did my site do on Google in the last 28 days?” and check the answer cites your real Search Console numbers.

# Plugin: the SEOmatic skills plus the hosted server
grok plugin marketplace add Minh42/seomatic-mcp
grok plugin install seomatic --trust
# start grok and ask a question; sign in when the browser opens

# Or the server only:
grok mcp add --transport http seomatic https://app.seomatic.ai/api/mcp

# Headless, SSH or CI: use an API key from the environment
grok mcp add --transport http seomatic https://app.seomatic.ai/api/mcp \
  --header "Authorization: Bearer ${SEOMATIC_API_KEY}"

Plugin, Grok Mcp Add or config.toml?

Pick the plugin. It connects the same SEOmatic server as the other two and adds SEOmatic's skills, so Grok Build already knows the audit, striking-distance and weekly-brief workflows.

Try Asking#

• “Which of my pages get seen on Google but rarely clicked? Fix their titles in the repo.”
• “Inspect my top 20 URLs and tell me which are not indexed and why.”
• “Audit the site before this release and list anything that blocks indexing.”
• “Find the queries where I rank on page 2 and draft what each page is missing.”
• “Check my sitemaps in Search Console and fix the generator if any have errors.”
• “Compare clicks for the last 28 days with the 28 days before and find the cause of any drop in the code.”

What It Costs#

Connecting is free. Reading your own data never uses credits: Search Console performance and insights, index status, rankings, site audits, AI citations, traffic and your tasks. Only live market lookups (keyword metrics, search results, backlinks), AI visibility scans and the fixes you approve use AI credits; every tool is labelled free or billed. On the Free plan, market lookups count against 5 free questions a month. The workspace Owner sees every credit spent, by feature, in Settings > Usage. Grok Build itself is billed by its maker, not by SEOmatic: nothing on our side counts tokens.

Nothing Changes on Your Site Without Your Approval#

Grok Build edits your code; it never pushes changes to your live CMS on its own. A staged change is a proposal: it says what will change and why, and nothing touches your site until you approve it. The assistant records your decision, and it is told never to approve anything on its own judgment. Approved fixes start within seconds, the page's previous state is stored, and any applied change can be rolled back. Changes that could take a page out of Google, like a noindex, need an extra explicit confirmation. Code changes follow your normal review: nothing ships until you merge and deploy it.

Grok Build says SEOmatic is connected but answers without my data.

Start a new chat and check that SEOmatic is enabled for that conversation in the tools menu. This is the step most people miss.

The SEOmatic page says "This connection request expired".

Start the connection again from Grok Build, or paste the setup prompt again.

The Authorize page shows the wrong email or no workspace.

Click Switch account on that page and sign in with the SEOmatic account that owns the site.

Why does Grok Build say it cannot change my site?

Fixes need a live paid plan or trial. On the Free plan, or when billing is paused or failed, your assistant can read and answer only.

How do I disconnect?

Open Settings > AI Agents, scroll to API Keys and delete the row named OAuth: Grok Build. See disconnect an assistant.