Getting Started
How do I start the MCP server?
1. Open Agent Browser on your iOS device
2. Scroll down to the MCP Server section
3. Tap Start to launch the server
4. Note the displayed IP address and port number (default: 9315)
How do I connect from my computer?
1. Make sure your computer and iOS device are on the same WiFi network
2. Find your iOS device IP address in the app
3. Connect using the MCP endpoint:
http://[device-ip]:9315/mcp
Test the connection:
curl http://192.168.1.100:9315/health
Frequently Asked Questions
What is MCP?
MCP (Model Context Protocol) is a standard protocol for AI tools to interact with external services. Agent Browser implements an MCP server that allows AI agents to control the browser.
Which AI tools work with Agent?
Agent works with any MCP-compatible client, including:
- Claude Desktop
- Cherry Studio
- Cursor
- Custom Python scripts using FastMCP
- Any tool supporting Streamable HTTP MCP transport
What tools are available?
Navigation: navigate go_back go_forward reload
Page Analysis: snapshot get_content get_title get_url
Interaction: click fill type scroll submit
Utilities: screenshot execute_js load_html
Troubleshooting
Cannot connect to MCP server
- Ensure both devices are on the same WiFi network
- Verify the MCP server is running (green indicator)
- Check that your firewall allows connections on port 9315
- Make sure you are using the correct IP address
Click or Fill not working
- Get a fresh snapshot before interacting (refs may have changed)
- Make sure the element is visible (try scrolling)
- Some websites block automated interactions