How do I install the aluvia mcp server?

Use a recorded configuration for your client, replace example credential values and paths, and verify the documented runtime. Restart or reconnect the client, then inspect the available tools.

What credentials does it need?

It reads `ALUVIA_API_KEY` from the environment. Store these in your client's env block or a secrets manager — never commit them to a repository — and grant the narrowest scope that still covers your use case.

Aluvia MCP Server — Tools & Setup

What is the Aluvia MCP Server?

The Aluvia MCP server exposes browser session management, geo-targeting, and account operations as Model Context Protocol tools for AI agents.

The short version

This repository is organized as a monorepo with three packages:

CLI for browser automation — — launch headless Chromium sessions from the command line, with JSON output designed for AI agent frameworks
Automatic block detection and unblocking — — the SDK detects 403s, WAF challenges, and CAPTCHAs, then reroutes through Aluvia and reloads the page automatically
Smart routing — — proxy only the sites that block you; everything else goes direct to save cost and latency
Runtime rule updates — — add hostnames to proxy rules on the fly, no restarts or redeployments
Adapters for every tool — — Playwright, Puppeteer, Selenium, Axios, got, and Node's fetch
IP rotation and geo targeting — — rotate IPs or target specific US regions at runtime

More MCP options

Compare MCP servers by category, or browse hosted MCP servers if you prefer an endpoint over a local process.

Maintainer setup documentation.

How to install the Aluvia MCP Server

{
  "mcpServers": {
    "github-com-aluvia-connect-sdk-node-tree-main-packages": {
      "command": "npx",
      "args": ["-y", "@aluvia/sdk"],
      "env": {
        "ALUVIA_API_KEY": "your-value"
      }
    }
  }
}

Add to claude_desktop_config.json, then restart Claude Desktop.

Configuration

Variable	Description	Required
ALUVIA_API_KEY	Credential the server authenticates with.	Yes

Example prompts to try

“Use Aluvia to Examples.”
“Use Aluvia to Endpoints.”
“Use Aluvia to Example.”

Frequently asked questions

The Aluvia MCP server exposes browser session management, geo-targeting, and account operations as Model Context Protocol tools for AI agents. Confirm the tools offered by your installed version in the connected client. Tool availability and permissions depend on the server and account configuration.

Aluvia MCP Server

What is the Aluvia MCP Server?

The short version

More MCP options

How to install the Aluvia MCP Server

Configuration

Example prompts to try

Frequently asked questions

Alternatives to the Aluvia MCP Server

Playwright

Puppeteer

Chrome DevTools

Browser MCP

BrowserTools

Playwright

Aluvia MCP Server

What is the Aluvia MCP Server?

The short version

More MCP options

How to install the Aluvia MCP Server

Configuration

Example prompts to try

Frequently asked questions

What does the aluvia mcp server do?

How do I install the aluvia mcp server?

What credentials does it need?

Alternatives to the Aluvia MCP Server

Playwright

Puppeteer

Chrome DevTools

Browser MCP

BrowserTools

Playwright