Skip to content

The Postgres development platform. Supabase gives you a dedicated Postgres database to build your web, mobile, and AI applications.

docs: add Grok plugin and MCP install instructions (#49212)

Pedro Rodriguesd3146a17550b
diff --git a/apps/docs/data/content-listings/ai-tools.data.ts b/apps/docs/data/content-listings/ai-tools.data.ts
index 6b4bf347d78..4b555dc87bc 100644
--- a/apps/docs/data/content-listings/ai-tools.data.ts
+++ b/apps/docs/data/content-listings/ai-tools.data.ts
@@ -15,12 +15,14 @@ const ICON_ASSETS: Record<string, { icon: string; hasLightIcon?: boolean }> = {
'claude-code': { icon: '/docs/img/icons/agent-claude-icon', hasLightIcon: false },
codex: { icon: '/docs/img/icons/agent-openai-icon', hasLightIcon: true },
cursor: { icon: '/docs/img/icons/agent-cursor-icon', hasLightIcon: true },
+ grok: { icon: '/docs/img/icons/agent-grok-icon', hasLightIcon: true },
'gemini-cli': { icon: '/docs/img/icons/agent-gemini-cli-icon', hasLightIcon: false },
'github-copilot': { icon: '/docs/img/icons/agent-copilot-icon', hasLightIcon: true },
kimi: { icon: '/docs/img/icons/agent-kimi-icon', hasLightIcon: true },
vscode: { icon: '/docs/img/icons/agent-vscode-icon', hasLightIcon: false },
antigravity: { icon: '/docs/img/icons/agent-antigravity-icon', hasLightIcon: false },
windsurf: { icon: '/docs/img/icons/agent-devin-icon', hasLightIcon: true },
+ warp: { icon: '/docs/img/icons/agent-warp-icon', hasLightIcon: true },
goose: { icon: '/docs/img/icons/agent-goose-icon', hasLightIcon: true },
factory: { icon: '/docs/img/icons/agent-factory-icon', hasLightIcon: true },
opencode: { icon: '/docs/img/icons/agent-opencode-icon', hasLightIcon: true },
diff --git a/apps/docs/features/ui/AgentPluginsPanel.data.ts b/apps/docs/features/ui/AgentPluginsPanel.data.ts
index 7678b94d615..91902ae6412 100644
--- a/apps/docs/features/ui/AgentPluginsPanel.data.ts
+++ b/apps/docs/features/ui/AgentPluginsPanel.data.ts
@@ -3,6 +3,7 @@ import type { McpClient } from 'ui-patterns/McpUrlBuilder'
export interface PluginClient extends McpClient {
repoUrl?: string
docsUrl?: string
+ docsLinkText?: string
}
export const PLUGIN_CLIENTS: PluginClient[] = [
@@ -25,6 +26,7 @@ export const PLUGIN_CLIENTS: PluginClient[] = [
key: 'cursor',
label: 'Cursor',
icon: 'cursor',
+ hasDistinctDarkIcon: true,
repoUrl: 'https://github.com/supabase-community/cursor-plugin',
docsUrl: 'https://cursor.com/docs/plugins',
},
@@ -44,6 +46,15 @@ export const PLUGIN_CLIENTS: PluginClient[] = [
docsUrl:
'https://docs.github.com/en/copilot/how-tos/copilot-cli/customize-copilot/plugins-finding-installing',
},
+ {
+ key: 'grok',
+ label: 'Grok',
+ icon: 'grok',
+ hasDistinctDarkIcon: true,
+ repoUrl: 'https://github.com/supabase-community/supabase-plugin',
+ docsUrl: 'https://docs.x.ai/build/features/skills-plugins-marketplaces#plugins',
+ docsLinkText: 'View Grok plugins docs',
+ },
{
key: 'kimi',
label: 'Kimi Code',
diff --git a/apps/docs/features/ui/AgentPluginsPanel.tsx b/apps/docs/features/ui/AgentPluginsPanel.tsx
index c5ebcf3e437..7df6f067d13 100644
--- a/apps/docs/features/ui/AgentPluginsPanel.tsx
+++ b/apps/docs/features/ui/AgentPluginsPanel.tsx
@@ -150,6 +150,26 @@ function PluginInstructions({ client }: { client: PluginClient }) {
)
}
+ if (client.key === 'grok') {
+ return (
+ <div className="space-y-3">
+ <p className="text-sm text-foreground-light">
+ Install the Supabase plugin by running the following command in your terminal.
+ </p>
+ <CodeBlock
+ value="grok plugin install supabase-community/supabase-plugin"
+ language="bash"
+ focusable={false}
+ className="block"
+ />
+ <p className="text-xs text-foreground-lighter">
+ Browse and install plugins in a session: run <code>grok</code>, then <code>/plugins</code>{' '}
+ or <code>/marketplace</code>.
+ </p>
+ </div>
+ )
+ }
+
if (client.key === 'vscode') {
return (
<div className="space-y-3">
@@ -240,7 +260,7 @@ export function AgentPluginsPanel() {
rel="noopener noreferrer"
className="text-brand-link hover:underline inline-flex items-center"
>
- View {selectedClient.label} extensions docs
+ {selectedClient.docsLinkText ?? `View ${selectedClient.label} extensions docs`}
<ExternalLink className="h-3 w-3 ml-1" />
</a>
</div>
diff --git a/apps/docs/public/img/icons/agent-grok-icon-light.svg b/apps/docs/public/img/icons/agent-grok-icon-light.svg
new file mode 100644
index 00000000000..8ac6121911a
--- /dev/null
+++ b/apps/docs/public/img/icons/agent-grok-icon-light.svg
@@ -0,0 +1,4 @@
+<svg width="24" height="24" viewBox="0 0 1024 1024" fill="none" xmlns="http://www.w3.org/2000/svg">
+<path d="M395.479 633.828L735.91 381.105C752.599 368.715 776.454 373.548 784.406 392.792C826.26 494.285 807.561 616.253 724.288 699.996C641.016 783.739 525.151 802.104 419.247 760.277L303.556 814.143C469.49 928.202 670.987 899.995 796.901 773.282C896.776 672.843 927.708 535.937 898.785 412.476L899.047 412.739C857.105 231.37 909.358 158.874 1016.4 10.6326C1018.93 7.11771 1021.47 3.60279 1024 0L883.144 141.651V141.212L395.392 633.916" fill="#0A0A0A"/>
+<path d="M325.226 695.251C206.128 580.84 226.662 403.776 328.285 301.668C403.431 226.097 526.549 195.254 634.026 240.596L749.454 186.994C728.657 171.88 702.007 155.623 671.424 144.2C533.19 86.9942 367.693 115.465 255.323 228.382C147.234 337.081 113.244 504.215 171.613 646.833C215.216 753.423 143.739 828.818 71.7385 904.916C46.2237 931.893 20.6216 958.87 0 987.429L325.139 695.339" fill="#0A0A0A"/>
+</svg>
diff --git a/apps/docs/public/img/icons/agent-grok-icon.svg b/apps/docs/public/img/icons/agent-grok-icon.svg
new file mode 100644
index 00000000000..1b71ff1ab24
--- /dev/null
+++ b/apps/docs/public/img/icons/agent-grok-icon.svg
@@ -0,0 +1,4 @@
+<svg width="24" height="24" viewBox="0 0 1024 1024" fill="none" xmlns="http://www.w3.org/2000/svg">
+<path d="M395.479 633.828L735.91 381.105C752.599 368.715 776.454 373.548 784.406 392.792C826.26 494.285 807.561 616.253 724.288 699.996C641.016 783.739 525.151 802.104 419.247 760.277L303.556 814.143C469.49 928.202 670.987 899.995 796.901 773.282C896.776 672.843 927.708 535.937 898.785 412.476L899.047 412.739C857.105 231.37 909.358 158.874 1016.4 10.6326C1018.93 7.11771 1021.47 3.60279 1024 0L883.144 141.651V141.212L395.392 633.916" fill="white"/>
+<path d="M325.226 695.251C206.128 580.84 226.662 403.776 328.285 301.668C403.431 226.097 526.549 195.254 634.026 240.596L749.454 186.994C728.657 171.88 702.007 155.623 671.424 144.2C533.19 86.9942 367.693 115.465 255.323 228.382C147.234 337.081 113.244 504.215 171.613 646.833C215.216 753.423 143.739 828.818 71.7385 904.916C46.2237 931.893 20.6216 958.87 0 987.429L325.139 695.339" fill="white"/>
+</svg>
diff --git a/apps/docs/public/img/icons/agent-warp-icon-light.svg b/apps/docs/public/img/icons/agent-warp-icon-light.svg
new file mode 100644
index 00000000000..ea1212cbc64
--- /dev/null
+++ b/apps/docs/public/img/icons/agent-warp-icon-light.svg
@@ -0,0 +1,3 @@
+<svg width="24" height="24" viewBox="0 0 24 24" fill="none" xmlns="http://www.w3.org/2000/svg">
+<path d="M12.035 2.723h9.253A2.712 2.712 0 0 1 24 5.435v10.529a2.712 2.712 0 0 1-2.712 2.713H8.047Zm-1.681 2.6L6.766 19.677h5.598l-.399 1.6H2.712A2.712 2.712 0 0 1 0 18.565V8.036a2.712 2.712 0 0 1 2.712-2.712Z" fill="#0B100F"/>
+</svg>
diff --git a/apps/docs/public/img/icons/agent-warp-icon.svg b/apps/docs/public/img/icons/agent-warp-icon.svg
new file mode 100644
index 00000000000..9799154c284
--- /dev/null
+++ b/apps/docs/public/img/icons/agent-warp-icon.svg
@@ -0,0 +1,3 @@
+<svg width="24" height="24" viewBox="0 0 24 24" fill="none" xmlns="http://www.w3.org/2000/svg">
+<path d="M12.035 2.723h9.253A2.712 2.712 0 0 1 24 5.435v10.529a2.712 2.712 0 0 1-2.712 2.713H8.047Zm-1.681 2.6L6.766 19.677h5.598l-.399 1.6H2.712A2.712 2.712 0 0 1 0 18.565V8.036a2.712 2.712 0 0 1 2.712-2.712Z" fill="#FFFFFF"/>
+</svg>
diff --git a/packages/ui-patterns/src/McpUrlBuilder/assets/grok-icon-dark.svg b/packages/ui-patterns/src/McpUrlBuilder/assets/grok-icon-dark.svg
new file mode 100644
index 00000000000..1b71ff1ab24
--- /dev/null
+++ b/packages/ui-patterns/src/McpUrlBuilder/assets/grok-icon-dark.svg
@@ -0,0 +1,4 @@
+<svg width="24" height="24" viewBox="0 0 1024 1024" fill="none" xmlns="http://www.w3.org/2000/svg">
+<path d="M395.479 633.828L735.91 381.105C752.599 368.715 776.454 373.548 784.406 392.792C826.26 494.285 807.561 616.253 724.288 699.996C641.016 783.739 525.151 802.104 419.247 760.277L303.556 814.143C469.49 928.202 670.987 899.995 796.901 773.282C896.776 672.843 927.708 535.937 898.785 412.476L899.047 412.739C857.105 231.37 909.358 158.874 1016.4 10.6326C1018.93 7.11771 1021.47 3.60279 1024 0L883.144 141.651V141.212L395.392 633.916" fill="white"/>
+<path d="M325.226 695.251C206.128 580.84 226.662 403.776 328.285 301.668C403.431 226.097 526.549 195.254 634.026 240.596L749.454 186.994C728.657 171.88 702.007 155.623 671.424 144.2C533.19 86.9942 367.693 115.465 255.323 228.382C147.234 337.081 113.244 504.215 171.613 646.833C215.216 753.423 143.739 828.818 71.7385 904.916C46.2237 931.893 20.6216 958.87 0 987.429L325.139 695.339" fill="white"/>
+</svg>
diff --git a/packages/ui-patterns/src/McpUrlBuilder/assets/grok-icon.svg b/packages/ui-patterns/src/McpUrlBuilder/assets/grok-icon.svg
new file mode 100644
index 00000000000..8ac6121911a
--- /dev/null
+++ b/packages/ui-patterns/src/McpUrlBuilder/assets/grok-icon.svg
@@ -0,0 +1,4 @@
+<svg width="24" height="24" viewBox="0 0 1024 1024" fill="none" xmlns="http://www.w3.org/2000/svg">
+<path d="M395.479 633.828L735.91 381.105C752.599 368.715 776.454 373.548 784.406 392.792C826.26 494.285 807.561 616.253 724.288 699.996C641.016 783.739 525.151 802.104 419.247 760.277L303.556 814.143C469.49 928.202 670.987 899.995 796.901 773.282C896.776 672.843 927.708 535.937 898.785 412.476L899.047 412.739C857.105 231.37 909.358 158.874 1016.4 10.6326C1018.93 7.11771 1021.47 3.60279 1024 0L883.144 141.651V141.212L395.392 633.916" fill="#0A0A0A"/>
+<path d="M325.226 695.251C206.128 580.84 226.662 403.776 328.285 301.668C403.431 226.097 526.549 195.254 634.026 240.596L749.454 186.994C728.657 171.88 702.007 155.623 671.424 144.2C533.19 86.9942 367.693 115.465 255.323 228.382C147.234 337.081 113.244 504.215 171.613 646.833C215.216 753.423 143.739 828.818 71.7385 904.916C46.2237 931.893 20.6216 958.87 0 987.429L325.139 695.339" fill="#0A0A0A"/>
+</svg>
diff --git a/packages/ui-patterns/src/McpUrlBuilder/clients.data.ts b/packages/ui-patterns/src/McpUrlBuilder/clients.data.ts
index b6b60aae141..996f4157b86 100644
--- a/packages/ui-patterns/src/McpUrlBuilder/clients.data.ts
+++ b/packages/ui-patterns/src/McpUrlBuilder/clients.data.ts
@@ -6,6 +6,7 @@ import type {
FactoryMcpConfig,
GeminiMcpConfig,
GooseMcpConfig,
+ GrokMcpConfig,
KimiMcpConfig,
McpClientBaseConfig,
McpClientConfig,
@@ -153,6 +154,23 @@ export const MCP_CLIENT_DATA: McpClientData[] = [
}
},
},
+ {
+ key: 'grok',
+ label: 'Grok',
+ icon: 'grok',
+ hasDistinctDarkIcon: true,
+ configFile: '~/.grok/config.toml',
+ externalDocsUrl: 'https://docs.x.ai/build/features/mcp-servers',
+ transformConfig: (config): GrokMcpConfig => {
+ return {
+ mcp_servers: {
+ supabase: {
+ url: config.mcpServers.supabase.url,
+ },
+ },
+ }
+ },
+ },
{
key: 'kimi',
label: 'Kimi Code',
@@ -375,6 +393,9 @@ export const MCP_CLI_COMMANDS: Record<string, McpCliCommands> = {
install: (url) => `codex mcp add supabase --url "${url}"`,
authenticate: 'codex mcp login supabase',
},
+ grok: {
+ install: (url) => `grok mcp add supabase "${url}" --transport http`,
+ },
'gemini-cli': {
install: (url) => `gemini mcp add -t http supabase "${url}"`,
authenticate: '/mcp auth supabase',
@@ -397,7 +418,7 @@ export const MCP_CLI_COMMANDS: Record<string, McpCliCommands> = {
export const MCP_CLIENT_GROUPS = [
{
heading: 'AI Agent CLI',
- keys: ['claude-code', 'codex', 'gemini-cli', 'copilot-cli', 'opencode', 'factory'],
+ keys: ['claude-code', 'codex', 'grok', 'gemini-cli', 'copilot-cli', 'opencode', 'factory'],
},
{
heading: 'Web Clients',
diff --git a/packages/ui-patterns/src/McpUrlBuilder/clients.instructions.md.tsx b/packages/ui-patterns/src/McpUrlBuilder/clients.instructions.md.tsx
index d768b97f660..f45aa6bedcd 100644
--- a/packages/ui-patterns/src/McpUrlBuilder/clients.instructions.md.tsx
+++ b/packages/ui-patterns/src/McpUrlBuilder/clients.instructions.md.tsx
@@ -88,6 +88,28 @@ export const MCP_CLIENT_INSTRUCTIONS: Record<string, McpClientInstructions> = {
</>
),
},
+ grok: {
+ primary: ({ url }) => (
+ <>
+ <paragraph>Add the Supabase MCP server to Grok:</paragraph>
+ <code lang="bash" value={MCP_CLI_COMMANDS['grok'].install!(url)} />
+ </>
+ ),
+ alternate: () => (
+ <>
+ <paragraph>
+ The command writes the server to your user config (
+ <inlineCode value="~/.grok/config.toml" />
+ ), making it available across all your projects. Start Grok and complete the Supabase
+ OAuth flow when prompted on first use.
+ </paragraph>
+ <paragraph>
+ Verify the connection by running <inlineCode value="/mcps" /> inside a Grok session, or{' '}
+ <inlineCode value="grok mcp doctor supabase" /> from your terminal.
+ </paragraph>
+ </>
+ ),
+ },
kimi: {
alternate: () => (
<>
diff --git a/packages/ui-patterns/src/McpUrlBuilder/types.ts b/packages/ui-patterns/src/McpUrlBuilder/types.ts
index 97a03ae103b..f1bdc14acc3 100644
--- a/packages/ui-patterns/src/McpUrlBuilder/types.ts
+++ b/packages/ui-patterns/src/McpUrlBuilder/types.ts
@@ -135,6 +135,19 @@ export interface CodexMcpConfig {
}
}
+/**
+ * Configuration format for Grok CLI MCP client.
+ * Grok reads a TOML config (`~/.grok/config.toml`) and, like Codex, keys
+ * servers under a `mcp_servers` table. HTTP transport is inferred from the URL.
+ */
+export interface GrokMcpConfig {
+ mcp_servers: {
+ supabase: {
+ url: string
+ }
+ }
+}
+
/**
* Configuration format for Gemini CLI MCP client.
* Uses httpUrl instead of url to match Gemini CLI's expected format.
@@ -199,6 +212,7 @@ export type McpClientConfig =
| FactoryMcpConfig
| GeminiMcpConfig
| GooseMcpConfig
+ | GrokMcpConfig
| KimiMcpConfig
| McpClientBaseConfig
| OpenCodeMcpConfig
diff --git a/packages/ui-patterns/src/McpUrlBuilder/utils/mcpIconAssets.ts b/packages/ui-patterns/src/McpUrlBuilder/utils/mcpIconAssets.ts
index 9b9ea2d02dd..7795c45bd6a 100644
--- a/packages/ui-patterns/src/McpUrlBuilder/utils/mcpIconAssets.ts
+++ b/packages/ui-patterns/src/McpUrlBuilder/utils/mcpIconAssets.ts
@@ -13,6 +13,8 @@ import factoryIcon from '../assets/factory-icon.svg'
import geminiCliIcon from '../assets/gemini-cli-icon.svg'
import gooseDarkIcon from '../assets/goose-icon-dark.svg'
import gooseIcon from '../assets/goose-icon.svg'
+import grokDarkIcon from '../assets/grok-icon-dark.svg'
+import grokIcon from '../assets/grok-icon.svg'
import kimiDarkIcon from '../assets/kimi-icon-dark.svg'
import kimiIcon from '../assets/kimi-icon.svg'
import kiroIcon from '../assets/kiro-icon.svg'
@@ -44,6 +46,7 @@ const MCP_CLIENT_ICON_ASSETS = {
factory: { light: factoryIcon, dark: factoryDarkIcon },
'gemini-cli': { light: geminiCliIcon, dark: geminiCliIcon },
goose: { light: gooseIcon, dark: gooseDarkIcon },
+ grok: { light: grokIcon, dark: grokDarkIcon },
kimi: { light: kimiIcon, dark: kimiDarkIcon },
kiro: { light: kiroIcon, dark: kiroIcon },
openai: { light: openaiIcon, dark: openaiDarkIcon },