For AI agents: a documentation index is available at /llms.txt
Skip to main content

Log in with an AI agent

Use the browserless_agent MCP tool to log in to a website and interact with authenticated content in a single conversation.

Prerequisites

Steps

Use the Browserless MCP server to log in to sites from any MCP-compatible AI agent (Claude Desktop, Cursor, Windsurf, ChatGPT, etc.).

1. Connect the MCP server

Send this prompt to your AI agent to install the Browserless MCP server:

Go to https://github.com/browserless/browserless-mcp/blob/main/install.md
and follow the instructions to install the Browserless MCP server
for my client.

2. Log in to a site

Use browserless_agent. It keeps a live browser session so it can fill forms, click buttons, and wait for redirects.

Use the browserless_agent tool to go to https://example.com/login,
enter my email user@example.com and password, click the login
button, and confirm I'm on the dashboard

3. Use an authenticated profile

If you already have a saved profile, use browserless_agent with that profile to skip the login step entirely. The profile loads your saved cookies and session data so the agent starts already logged in.

Set up the authenticated profile first through the Profiles page in your dashboard or using the REST or framework APIs. See Save Logins to Authenticated Profiles for REST and framework options.

Use the browserless_agent tool with my authenticated profile
"my-site" to go to https://example.com/dashboard and confirm
I'm logged in
note

browserless_agent can perform login interactions within a single conversation but cannot save profiles. To create reusable authenticated profiles, use the Profiles page in your dashboard or the REST or framework APIs.