Connect Gemini CLI to xSpeed Hub MCP

Steps

1. 1

   Add xSpeed Hub to Gemini CLI

   Run this once. --scope user writes the server to ~/.gemini/settings.json so it works in every project; without it Gemini CLI saves to the project's .gemini/settings.json, which is the default.

   Terminal Copy

   gemini mcp add --scope user --transport http xspeedhub https://app.xspeedcache.com/xspeed/mcp

2. 2

   Authenticate with /mcp auth

   Start gemini and run /mcp auth xspeedhub. A browser page opens where you sign in to xSpeed Hub and approve access, and Gemini CLI receives the redirect on a local port. There is no token to paste, and the client keeps the credentials it receives. Run /mcp afterwards to check that xspeedhub shows as connected and lists its tools.

   Text Copy

   /mcp auth xspeedhub

Sign-in

OAuth sign-in or connection token. Run /mcp auth xspeedhub and approve access in the browser; Gemini CLI registers itself, stores the tokens and refreshes them. If you prefer a header, pass the connection token from the Hub's Connect AI page with --header when you add the server.

{
  "mcpServers": {
    "xspeedhub": {
      "httpUrl": "https://app.xspeedcache.com/xspeed/mcp",
      "headers": {
        "Authorization": "Bearer <your connection token>"
      }
    }
  }
}

Check it worked

Ask Gemini CLI this. It only reads, so nothing changes on your sites.

Use xSpeed Hub to list my sites and tell me which of them have the preloader stopped.

A first prompt

With xSpeed Hub, show the page cache hit ratio for every site and flag any below 70%.

If something does not work

• OAuth needs a browser on the same machine and a localhost redirect. In a headless shell, an SSH session or a container without a browser, use the connection token header instead.
• The default scope of gemini mcp add is project. Add --scope user, or the server will look missing when you start Gemini CLI in another folder.
• Keep underscores out of the server name. Gemini CLI documents that its policy parser splits tool names at the first underscore, so a name like xspeed_hub could make allow and deny rules fail silently. The name xspeedhub is safe.
• Do not add --trust to this server, and do not start Gemini CLI with --approval-mode=yolo (or --yolo) while the Hub is connected. Each bypasses tool confirmations, including the ones for purges and settings changes.