Screenshot MCP Server for Gemini CLI

Set it up (recommended: sign in with OAuth)

Gemini CLI supports remote Streamable HTTP servers and runs the OAuth sign-in when the server asks for it.

1Run the command below. Gemini CLI defaults to the current project; -s user makes it global.
2Start gemini; on first use it opens a browser to sign in to SnapRender. /mcp auth snaprender repeats the sign-in.
3Ask Gemini to screenshot a page.

Terminal

gemini mcp add -s user --transport http snaprender https://app.snap-render.com/mcp

~/.gemini/settings.json

{
  "mcpServers": {
    "snaprender": { "httpUrl": "https://app.snap-render.com/mcp" }
  }
}

Check it worked: gemini mcp list in the shell, or /mcp inside Gemini CLI, shows the server and its tools.

With an API key instead

Pass the key as a header instead of signing in: Get a key from your SnapRender dashboard.

Terminal

gemini mcp add -s user --transport http \
  --header "Authorization: Bearer YOUR_API_KEY" snaprender https://app.snap-render.com/mcp

Or run the server locally

Runs the open-source server from npm locally. Replace YOUR_API_KEY with the key from your SnapRender dashboard. The package is snaprender-mcp on npm.

~/.gemini/settings.json

{
  "mcpServers": {
    "snaprender": {
      "command": "npx",
      "args": ["-y", "snaprender-mcp"],
      "env": { "SNAPRENDER_API_KEY": "YOUR_API_KEY" }
    }
  }
}

In settings.json, Streamable HTTP servers use httpUrl. The url field means the older SSE transport.

What Gemini CLI can do with it

take_screenshot

Capture any URL, HTML or Markdown as PNG, JPEG, WebP or PDF, full page or by device

extract_content

Read a page as markdown, text, article, links or metadata

batch_screenshots

Capture up to 50 URLs in one job

get_batch_status

Check a batch and get its download links

sign_screenshot_url

Create a shareable capture URL that does not expose your key

check_screenshot_cache

See whether a capture is cached, without spending quota

get_usage

Show renders used and left this month

list_webhooks

List your webhooks

create_webhook

Get notified when batches finish

delete_webhook

Remove a webhook

test_webhook

Send a test delivery

Prompts to try

"Take a full-page screenshot of https://stripe.com and tell me how the pricing section is laid out."
"Compare https://example.com on desktop and iPhone and list layout problems on mobile."
"Read https://example.com/docs as markdown and summarize the authentication steps."

SnapRender renders public pages from its own servers, with ads and cookie banners removed. Pages behind a login and localhost are out of reach; use a preview deployment or a tunnel for local work.

Questions

Why did Gemini CLI reject the sign-in with "Missing issuer parameter"?+

Gemini CLI checks the issuer on the OAuth response (RFC 9207). SnapRender returns it, so the sign-in completes; if you configured the server before October 2026, run /mcp auth snaprender again.

Other clients

Cursor VS Code (Copilot) Claude Code OpenAI Codex CLI Zed Windsurf (Devin Desktop) Cline Claude and Claude Desktop

Checked against geminicli.com in October 2026.

Give Gemini CLI eyes on the web