What you can do
- Profile management — create, update, delete, and list browser profiles
- Proxy configuration — set up proxies on profiles
- Fingerprint control — customize browser fingerprints and user agents
- Folder organization — create folders and organize profiles
- Browser sessions — start and stop browser sessions
- Account info — check subscription status and usage
Install
Requirements
- Node.js 18 or higher
- A Gologin API token
- An active Gologin account
Get your API token
- Log in at gologin.com
- Open API & MCP in the dashboard
- Open the API tab
- Click New Token and copy it
Claude Desktop
- Open Claude Desktop → Settings
- Click Developer in the sidebar, then Edit Config
- Add to
claude_desktop_config.json:
- Restart Claude Desktop
- Check Settings → Connectors for “gologin-mcp LOCAL”
Claude Code
Add to your Claude Code MCP settings:Cursor
Use the same JSON configuration in Cursor’s MCP settings file.Other MCP clients
Any client that supports the Model Context Protocol can use the same configuration structure.Usage examples
Once connected, talk to your AI assistant naturally: Account- “What’s my Gologin account status?”
- “Check my subscription details”
- “Create a new browser profile with a US proxy”
- “Set up 5 profiles for social media management”
- “Show me all my profiles”
- “Update the proxy for profile ID 123 to use a UK proxy”
- “Delete the profile named ‘test-profile’”
- “Create a folder called ‘Social Media Accounts’”
- “Move profile XYZ to the Social Media folder”
- “Start a browser session for my profile”
- “Stop all running browser sessions”
Real-world scenarios
Set up profiles for a new client
You’re onboarding a new client who needs 10 browser profiles for different regional ad accounts:“Create 10 browser profiles named ‘Client X - US’, ‘Client X - UK’, ‘Client X - DE’ and so on. Set each one with a residential proxy from its respective country. Put them all in a folder called ‘Client X’.”Claude creates the profiles, configures proxies, and organizes them — all through natural language.
Audit your existing setup
“Show me all profiles that don’t have a proxy configured. Also, which profiles haven’t been used in the last 30 days?”Quick way to find misconfigured or abandoned profiles without clicking through the dashboard.
Prepare profiles before automation
MCP Server handles the setup; CLI tools handle the execution:- MCP: “Create 5 profiles with US proxies for scraping, put them in a ‘Scraping’ folder”
- CLI:
gologin-agent-browser open https://target.com --profile profile_1to run automation - MCP: “Delete all profiles in the ‘Scraping’ folder” when done
Team management
“How many active sessions are running right now? What’s my plan’s session limit?” “Check my subscription — how many profiles do I have left?”Useful for team leads who need to monitor usage without opening the dashboard.
MCP Server vs CLI tools vs AI Skills
MCP Server focuses on profile and account management. For web scraping and browser automation, use the CLI tools or AI Skills.
Related
- AI Skills — plug-and-play web access skills for Claude Code
- Web Access CLI — unified scraping + browser CLI
- Agent Browser CLI — cloud browser CLI for AI agents
npm package
gologin-mcp
Source code
gologinapp/gologin-mcp