Quickstart

Shade exposes a streamable HTTP MCP endpoint at https://api.shade.atlas-ai.au/mcp. Create an API key in the dashboard, add the MCP server to your client, claim a browser slot, do the work, then release the slot.

1. Create an API key

Open the Shade dashboard, create an API key, and copy it immediately. The dashboard only shows the plaintext key once.

2. Add Shade to your MCP client

claude mcp add --transport http shade https://api.shade.atlas-ai.au/mcp --header "Authorization: Bearer YOUR_KEY"

The Claude Code command above is verified against claude mcp add --help.

export SHADE_API_KEY="YOUR_KEY"
codex mcp add shade --url https://api.shade.atlas-ai.au/mcp --bearer-token-env-var SHADE_API_KEY

The Codex command above is verified against codex mcp add --help. It keeps the key in an environment variable instead of putting the bearer token directly in the MCP config.

Use your MCP client's streamable HTTP configuration:

Name: shade
URL: https://api.shade.atlas-ai.au/mcp
Transport: streamable HTTP
Header: Authorization: Bearer YOUR_KEY

If your client uses different names for these fields, use its MCP documentation and preserve the same URL and Authorization header exactly.

3. Claim a slot

Ask your client to call:

browser_claim_slot

The result includes the slot number assigned to this agent run.

4. Navigate

Call:

browser_navigate(url: "https://example.com", slot: YOUR_SLOT)

Then use the other browser tools for snapshots, clicks, typing, session saves, leak checks, or Web3 monitoring.

5. Release the slot

When the run is done, call:

browser_release_slot(slot: YOUR_SLOT)

Releasing the slot stops the browser process and frees capacity for the next agent run.

Quickstart

Quickstart

1. Create an API key

2. Add Shade to your MCP client

3. Claim a slot

4. Navigate

5. Release the slot

On this page