← back

Docs

Everything you need to get started.

Quick start

1. Clone and run

git clone https://github.com/EduardoFazolo/iframer-agentic-browser
cd iframer-agentic-browser
docker compose up -d

2. Authenticate

node bin/cli.js login

3. Add MCP to your agent

// .mcp.json
{
"mcpServers": {
"agentic-browser": {
"command": "node",
"args": ["path/to/mcp/index.js"]
}
}
}

4. Talk to your agent

"Log into my GitHub account and star the iframer repo"

MCP Tools

status
Full state in one call. Call first.
browse
Headless fetch. Fast, no vision.
interactive_start
Open headful browser.
interactive_act
Send action, get result.
interactive_batch
N actions in one call.
interactive_screenshot
Screenshot as URL.
interactive_stop
Save session, close.
login
Fill login form securely.
store_credentials
Prompt user, encrypt, save.
list_credentials
List stored domains.
clear_session
Wipe stored session.

Actions

Use with interactive_act or interactive_batch.

click
selector
Click element
human-click
selector | x,y
Human-like click
human-type
selector, value
Human-like typing
fill
selector, value
Fast fill
navigate
url
Go to URL
scroll
deltaY?
Scroll
wait
ms
Wait
evaluate
expression
Run JS
keyboard
key
Press key
recaptcha-click
—
Click checkbox
recaptcha-select
tiles[]
Select tiles
recaptcha-verify
—
Click verify

Security

  • —Credentials encrypted with AES-256-GCM, key derived from your token via HKDF
  • —Server decrypts for milliseconds during login, then discards plaintext
  • —AI model never receives credential values — only success/failure
  • —Sessions isolated per user — separate encryption keys, separate Redis keys
  • —Write-only credential API — no endpoint returns stored values
HomeGet startedGitHub

Open source · MIT license · 2026