squirrelscan for Gemini CLI

1. 1

   Install the squirrelscan CLI (optional)

   Free local audits, handy for quick one-off checks from the same shell.

   bash

   curl -fsSL https://install.squirrelscan.com | bash

1. 1

   Add the hosted MCP server

   One command registers the streamable HTTP server. gemini mcp add defaults to project scope, so pass --scope user to make squirrelscan available in every project.

   bash

   gemini mcp add --transport http --scope user squirrelscan https://mcp.squirrelscan.com/mcp

   MCP client setup for Gemini CLI
2. 2

   Or edit settings.json directly

   Gemini CLI reads MCP servers from ~/.gemini/settings.json (user) or a project .gemini/settings.json. Use httpUrl for a streamable HTTP server; $SQUIRRELSCAN_API_KEY expands from your environment so the key stays out of the file.

   json

   {
     "mcpServers": {
       "squirrelscan": {
         "httpUrl": "https://mcp.squirrelscan.com/mcp",
         "headers": { "Authorization": "Bearer $SQUIRRELSCAN_API_KEY" }
       }
     }
   }

   Authentication and API keys
3. 3

   Ask Gemini to audit a site

   Describe the task in plain language once the server is connected.

   text

   Audit https://example.com with squirrelscan and list the top 3 fixes

Frequently asked questions

How do I get Gemini CLI to audit and fix my site's SEO?

Connect the hosted squirrelscan MCP server, then ask Gemini in plain language to audit a URL. It calls run_audit, polls until the report is ready, and returns concrete fixes across SEO, performance, security, accessibility, and more. Because Gemini CLI is a coding agent, it can then edit your source to apply the fixes and re-audit.Fix your site with an AI agent

Do I need a squirrelscan account to use it from Gemini CLI?

Local audits with the free squirrel CLI need no account. The hosted MCP server does: on first connect Gemini CLI runs an OAuth browser sign-in, or you set an Authorization: Bearer header with an API key from squirrel keys create. Either way squirrelscan knows which organization to bill.Authentication

Is auditing through Gemini CLI free?

Local CLI audits are free and unlimited. Cloud audits over the hosted MCP server spend pay-as-you-go credits (50 per audit plus 2 per rendered page), and run_audit returns a cost estimate before anything runs. Every account gets 500 free credits a month.Cloud credits

Can I scope squirrelscan to a single project in Gemini CLI?

Yes. gemini mcp add defaults to project scope and writes .gemini/settings.json in the current directory. Add --scope user, or edit ~/.gemini/settings.json, to make squirrelscan available in every project instead.MCP client setup for Gemini CLI

Can Gemini CLI audit my site on every deploy?

Yes. For a plain pass/fail gate you do not need the agent: the free squirrel CLI exits non-zero when the score drops below your threshold (squirrel audit URL --fail-on 'score<90'), so any CI runner can block a bad deploy. To drive it through Gemini in CI, set the Authorization: Bearer header from SQUIRRELSCAN_API_KEY so no browser sign-in is needed.CI gating guide

Can I install squirrelscan as a Gemini CLI extension?

Not as an official extension yet. squirrelscan connects today as an MCP server through ~/.gemini/settings.json or gemini mcp add. Gemini CLI extensions can bundle MCP servers and commands, so this may change, but the settings.json entry is the supported path right now.