Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| CAMOFOX_URL | No | CamoFox server URL | http://localhost:9377 |
| CAMOFOX_API_KEY | No | API key (if CamoFox requires auth) | |
| CAMOFOX_TIMEOUT | No | Request timeout in ms | 30000 |
Capabilities
Features and capabilities supported by this server
| Capability | Details |
|---|---|
| tools | {
"listChanged": true
} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| server_status | Check CamoFox server health and browser connection. Call first to verify server is running. Returns version, browser status, and active tab count. |
| create_tab | Create a new browser tab with anti-detection fingerprinting. Each tab gets a unique fingerprint. Optionally provide a URL and userId for session isolation. Returns the tab ID for subsequent operations. |
| close_tab | Close a browser tab and release resources. Always close tabs when done to free memory. |
| list_tabs | List all open browser tabs with URLs and titles. Use to discover available tabs or verify tab state. |
| navigate | Navigate a tab to a URL. Waits for page load. Use create_tab first, then navigate. Returns final URL (may differ due to redirects). |
| go_back | Navigate backward in browser history (Back button). Returns new page URL. |
| go_forward | Navigate forward in browser history (Forward button). Returns new page URL. |
| refresh | Reload the current page. Useful when page state is stale or after changes. |
| click | Click an element. Provide either ref (from snapshot) or CSS selector. Use snapshot first to discover element refs. |
| type_text | Type text into an input field. Provide either a ref (from snapshot) or a CSS selector. Use ref when available; use selector as fallback when snapshot doesn't assign refs (common with combobox/autocomplete inputs). Call snapshot first to find target element. |
| scroll | Scroll page up or down by pixel amount. Use to reveal content below the fold or navigate long pages. |
| camofox_press_key | Press a keyboard key. Use after type_text to submit forms (Enter), navigate between elements (Tab), move through suggestions (ArrowDown/ArrowUp), or dismiss dialogs (Escape). Common keys: Enter, Tab, Escape, ArrowDown, ArrowUp, Backspace, Space. |
| snapshot | Get accessibility tree snapshot — the PRIMARY way to read page content. Returns element refs, roles, names and values. Token-efficient. Always prefer over screenshot. Element refs are used with click and type_text. |
| screenshot | Take visual screenshot as base64 PNG. Use ONLY for visual verification (CSS, layout, proof). Prefer snapshot for most tasks — much more token-efficient. |
| get_links | Get all hyperlinks on page with URLs and text. Useful for navigation discovery and site mapping. |
| web_search | Search the web via 14 engines: google, youtube, amazon, bing, duckduckgo, reddit, github, stackoverflow, wikipedia, twitter, linkedin, facebook, instagram, tiktok. Call snapshot after to read results. |
| import_cookies | Import cookies for authenticated sessions. Provide cookies as JSON string array. Restores login sessions without re-auth. Requires userId. |
| get_stats | Get session statistics: request counts, active tabs, uptime, performance metrics. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |