Agent plugins

Use the Allscreenshots MCP server with Claude Code, OpenAI Codex, Cursor, VS Code Copilot, Gemini CLI, Windsurf, or any client that can launch a Model Context Protocol server.

Source code: GitHub

What the plugin adds

The plugin exposes two tools to your agent:

Tool	Purpose
`take_screenshot`	Captures a website screenshot and saves it to a local file
`get_api_info`	Returns API links, supported formats, and API key setup guidance

take_screenshot supports viewport width and height, png, jpeg, and webp output, full-page capture, capture delay, dark mode, and ad or cookie banner blocking.

The Codex plugin also includes a screenshot skill so prompts such as "make a screenshot of example.com" prefer the Allscreenshots API instead of the Browser plugin.

Installation

/plugin marketplace add allscreenshots/allscreenshots-plugin
/plugin install allscreenshots@allscreenshots

Restart Claude Code after installation.

codex plugin marketplace add allscreenshots/allscreenshots-plugin
codex
/plugins

Choose the Allscreenshots marketplace, open the Allscreenshots plugin, and install it.

If you installed an older version, refresh the marketplace before reinstalling:

codex plugin marketplace upgrade allscreenshots

uv run --with "fastmcp>=2.0" --with "httpx>=0.27" fastmcp run /path/to/allscreenshots-plugin/mcp_server/server.py

Setup

Get an API key

Create or copy an API key from the dashboard.

Configure the MCP server

For Codex, store the key in the Allscreenshots CLI config file. This is more reliable than inherited environment variables because Codex can filter environment variables for subprocesses:

allscreenshots config add-authtoken YOUR_API_KEY

On macOS, this writes to ~/Library/Application Support/com.allscreenshots.cli/config.toml.

The MCP server also supports ALLSCREENSHOTS_API_TOKEN, ALLSCREENSHOTS_TOKEN, ALLSCREENSHOTS_API_KEY, and the direct api_key tool parameter when those are available.

Ask your agent for a screenshot

Take a screenshot of https://example.com

Example prompts

"Take a screenshot of https://example.com"
"Capture a full-page screenshot of our landing page"
"Screenshot this page in dark mode"
"Take a mobile screenshot of https://example.com"
"Grab a screenshot without ads or cookie banners"
"How do I get an Allscreenshots API key?"

Troubleshooting

If Codex reports that the allscreenshots MCP server failed to start during activation, upgrade the marketplace and reinstall or re-enable the plugin from /plugins:

codex plugin marketplace upgrade allscreenshots

If the server starts but says the API key is missing, upgrade to the latest plugin version and use allscreenshots config add-authtoken YOUR_API_KEY. Older releases set an empty API key in .mcp.json, and Codex can also filter inherited environment variables for subprocesses.

Codex marketplace metadata

The repository includes the Codex plugin manifest and marketplace catalog:

.codex-plugin/plugin.json
.mcp.json
.agents/plugins/marketplace.json

For local development, add the checked-out repository as a marketplace:

codex plugin marketplace add ./path/to/allscreenshots-plugin
codex
/plugins

Local development

git clone https://github.com/allscreenshots/allscreenshots-plugin
cd allscreenshots-plugin
uv run --with "fastmcp>=2.0" --with "httpx>=0.27" fastmcp inspect mcp_server/server.py

Agent Plugins