[Feature Request] Add ProxyToolkit for mobile proxy management (Proxies.sx integration) #3859
Description
Prerequisites
- I have searched the existing issues and this has not been reported before
- I have read the documentation
- I am using the latest version of CAMEL
Motivation
CAMEL has 86 toolkits including 5+ browser toolkits (browser_toolkit, async_browser_toolkit, hybrid_browser_toolkit, playwright_mcp_toolkit, screenshot_toolkit) but no dedicated proxy infrastructure toolkit. Agents using browser toolkits frequently need:
- Real mobile IPs to bypass anti-bot detection (datacenter and residential IPs are increasingly fingerprinted)
- Geo-specific proxy rotation across multiple countries
- Persistent browser identities with proxy binding
A ProxyToolkit would complement the existing browser toolkit ecosystem, enabling agents to combine stealth browsing with real 4G/5G carrier IPs.
Solution
Proposed ProxyToolkit (following CAMEL toolkit conventions):
from camel.toolkits import ProxyToolkit
proxy_toolkit = ProxyToolkit()
# Get tools for agent
tools = proxy_toolkit.get_tools()
# Returns: [get_proxy, rotate_ip, check_status, get_browser_session]Integration with existing browser toolkits:
from camel.toolkits import HybridBrowserToolkit, ProxyToolkit
# Agent with stealth browsing + mobile proxy
browser = HybridBrowserToolkit(proxy=ProxyToolkit(country="US"))
agent = ChatAgent(tools=[*browser.get_tools()])Tool functions:
get_proxy(country, tier)— Acquire mobile proxy credentials (HTTP/SOCKS5)rotate_ip(proxy_id)— Rotate IP on active proxy (triggers airplane mode toggle on real modem)check_status(proxy_id)— Check proxy online/offline statusget_browser_session(country)— Launch antidetect browser with auto-allocated mobile proxy- x402 USDC micropayments — agents self-provision without API keys or accounts
MCP server integration (alternative path):
The proxy infrastructure is also available as MCP servers that work with CAMEL's existing mcp_toolkit.py:
@proxies-sx/mcp-server— 3 proxy management tools@proxies-sx/browser-mcp— 11 browser control tools
Alternatives
- Using
playwright_mcp_toolkit.pywith manual proxy config (no mobile IPs available) - Using raw MCP connection to external server (less integrated than a native toolkit)
- Datacenter proxies (easily detected by modern anti-bot systems, not real carrier IPs)
Additional Context
Infrastructure:
- 155+ real 4G/5G mobile modems across US, DE, GB, FR, ES, PL
- Pool gateway: HTTP proxy (port 7000) + SOCKS5 (port 7001)
- IP rotation via real airplane mode toggle on physical devices
Payment:
- x402 USDC micropayments on Base and Solana — no accounts or API keys needed
- $4/GB shared, $8/GB private, antidetect browser ~$0.005/min
Published packages:
- npm:
@proxies-sx/mcp-server,@proxies-sx/browser-mcp - npm:
@proxies-sx/x402-core,@proxies-sx/x402-hono,@proxies-sx/x402-solana
Related issues:
- [Feature Request]
BrowserToolkitenhancement roadmap #2886 (BrowserToolkit enhancement roadmap) - [Feature Request] Make HybridBrowserToolkit as MCP #2921 (HybridBrowserToolkit as MCP)
- feat: add Toolathlon mcp tools #3846 (feat: add Toolathlon mcp tools)
Links:
- Website: https://agents.proxies.sx
- x402 Discovery: https://agents.proxies.sx/.well-known/x402.json
- MCP Server: https://www.npmjs.com/package/@proxies-sx/mcp-server
- Browser MCP: https://www.npmjs.com/package/@proxies-sx/browser-mcp
Happy to submit a PR implementing this toolkit.