Connect your AI to Search Genie
Search Genie exposes a Model Context Protocol (MCP) server, so AI clients like Claude, Cursor, and ChatGPT can query your brand's search-intelligence data directly. ChatGPT and Claude use secure OAuth; command-line clients can use an expiring header key.
https://qvhgjtqzsuddfuqkasbk.supabase.co/functions/v1/mcp-serverWhat each package can do
The tools your AI client can call are gated by your Search Genie package. Capabilities below describe what is available per package.
| Capability | Starter | Growth | Enterprise |
|---|---|---|---|
| Read surfaces (overview, prompt search, share of voice, organic performance, blog listing) | Not available | Included | Included |
| Opportunities, keyword research, page scraping | — | Included | Included |
| SEO action generation, full blog creation | — | — | Included |
| Connector access level | Not available | Read | Full |
| Rate limit (requests / minute) | — | 60 | 120 |
MCP requires a live Growth or Enterprise workspace subscription. A connector or CLI key can request less access than the plan, but it can never raise the plan's access.
Set up your client
Use OAuth for current ChatGPT and Claude remote connectors. Use an expiring API key only for command-line or local clients that can send an Authorization header.
ChatGPT and Claude — OAuth (recommended)
In ChatGPT or Claude's remote connector settings, add a custom connector and paste the plain endpoint below. The client will redirect you to Search Genie to sign in, choose one brand and approve a package ceiling. No secret is pasted into the URL.
https://qvhgjtqzsuddfuqkasbk.supabase.co/functions/v1/mcp-serverThe OAuth grant appears under Settings → API Connections and can be revoked immediately. Access tokens are short-lived; the connector refreshes them without exposing a reusable API key.
CLI and local clients
Replace sgk_YOUR_KEY_HERE with an expiring, brand-scoped key created inside the app.
Claude Code
A single command adds Search Genie over streaming HTTP with the key passed as an Authorization header.
claude mcp add --transport http search-genie https://qvhgjtqzsuddfuqkasbk.supabase.co/functions/v1/mcp-server --header "Authorization: Bearer sgk_YOUR_KEY_HERE"Cursor
Add a search-genie entry to ~/.cursor/mcp.json.
{
"mcpServers": {
"search-genie": {
"url": "https://qvhgjtqzsuddfuqkasbk.supabase.co/functions/v1/mcp-server",
"headers": {
"Authorization": "Bearer sgk_YOUR_KEY_HERE"
}
}
}
}Claude Desktop
Claude Desktop speaks stdio, so bridge to the HTTP endpoint with the mcp-remote helper in your claude_desktop_config.json.
{
"mcpServers": {
"search-genie": {
"command": "npx",
"args": [
"-y",
"mcp-remote",
"https://qvhgjtqzsuddfuqkasbk.supabase.co/functions/v1/mcp-server",
"--header",
"Authorization: Bearer sgk_YOUR_KEY_HERE"
]
}
}
}Deep-research eligible. Search Genie exposes the required search and fetch tools for clients that support MCP deep-research sources.
Rate limits
Requests are throttled per package, counted per minute.
| Package | Limit |
|---|---|
| Growth | 60 / min |
| Enterprise | 120 / min |
Exceed a limit and the tool call returns a retry-after error — your client should back off and retry after the indicated delay.
Get your key
For CLI and local clients only, mint and revoke an expiring, brand-scoped sgk_… key inside the app at Settings → API Connections. Keys are shown once at creation. Store yours safely and revoke it from the same screen if it leaks.