Model Context Protocol

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.

Endpointhttps://search-genie.hyvelabs.tech/mcp

What 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 connector settings, add a custom connector and paste the plain endpoint below. The client redirects you to Search Genie to sign in, choose one brand and approve a package ceiling. No secret is pasted into the URL.

remote connector url

https://search-genie.hyvelabs.tech/mcp

The 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.

Before you start

Your workspace needs a live Growth or Enterprise subscription.
The person who approves the connection must be a workspace admin with two-step verification (authenticator code or passkey) already set up on their Search Genie account.
Each connection sees exactly one brand. Connect a second brand with a second connection.
Copy the endpoint from this page or from Settings → API Connections. Never put a key in the URL.

ChatGPT (web or desktop)

Open Settings → Connectors → Advanced and turn on Developer mode (required for custom MCP servers; Plus, Pro, Team and Enterprise plans).
Back under Connectors, choose Create. Name it "Search Genie", paste the endpoint above as the MCP server URL, and set Authentication to OAuth.
Create it. ChatGPT opens the Search Genie sign-in and consent page.
Sign in, complete two-step verification, choose the workspace, the brand and the access level, then press Approve connection.
In a chat, enable the Search Genie connector (or Deep research → sources) and ask a question about your brand.

Claude (claude.ai and Claude Desktop)

Open Settings → Connectors and choose Add custom connector.
Name it "Search Genie" and paste the endpoint above. Leave the OAuth client fields empty: Search Genie registers the client automatically.
Press Add, then Connect. Claude opens the Search Genie consent page.
Sign in, complete two-step verification, choose the workspace, the brand and the access level, then approve.
Enable the connector in a conversation. On Claude Desktop the same connector list is available under Settings → Connectors; the mcp-remote configuration below is only for setups that cannot use connectors.

If something does not work

"Requires a live Growth or Enterprise subscription": the subscription, not the connection, is the blocker. Check Settings → Billing.
The consent page refuses you: you are not a workspace admin, or two-step verification is not set up. Ask an admin to approve, or enable verification under Settings → Security first.
A tool is missing in the assistant: tools follow the smaller of the connection's package and your plan. New tools only appear after the connector is removed and added again; "Reconnect" does not refresh the list.
"Failed to create grant" when re-adding: deleting a connector in the assistant leaves its grant behind. Revoke the old "OAuth: …" row under Settings → API Connections, then add the connector again.
Rate-limit messages: the assistant is told how long to wait; repeated bursts suspend the connection for 15 minutes.

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.

terminal

claude mcp add --transport http search-genie https://search-genie.hyvelabs.tech/mcp --header "Authorization: Bearer sgk_YOUR_KEY_HERE"

Cursor

Add a search-genie entry to ~/.cursor/mcp.json.

~/.cursor/mcp.json

{
  "mcpServers": {
    "search-genie": {
      "url": "https://search-genie.hyvelabs.tech/mcp",
      "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.

claude_desktop_config.json

{
  "mcpServers": {
    "search-genie": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://search-genie.hyvelabs.tech/mcp",
        "--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.

Open API Connections →