Skip to main content

agnt MCP Server

The agnt MCP server provides browser debugging tools for Claude Code, enabling navigation, screenshots, DOM inspection, and network monitoring.

Installation​

# Using npx (recommended)
npx @standardbeagle/agnt@latest mcp

# Global installation
npm install -g @standardbeagle/agnt
agnt mcp

Configuration​

Claude Code​

{
  "mcpServers": {
    "agnt": {
      "command": "npx",
      "args": ["-y", "@standardbeagle/agnt@latest", "mcp"],
      "env": {
        "AGNT_DAEMON_URL": "http://localhost:8080"
      }
    }
  }
}

Environment Variables​

VariableDescriptionDefault
AGNT_DAEMON_URLURL of agnt daemonhttp://localhost:8080
AGNT_SESSION_CODESession identifierAuto-generated

Available Tools​

ToolDescriptionParameters
navigateNavigate to URLurl: string
go_backGo back in history-
go_forwardGo forward in history-
refreshRefresh current page-

Screenshots​

ToolDescriptionParameters
screenshotCapture page screenshotselector?: string, full_page?: boolean
screenshot_elementScreenshot specific elementselector: string

DOM Inspection​

ToolDescriptionParameters
get_htmlGet page HTMLselector?: string
get_textGet element textselector: string
get_attributesGet element attributesselector: string
query_selector_allQuery multiple elementsselector: string

Interaction​

ToolDescriptionParameters
clickClick elementselector: string
typeType text into inputselector: string, text: string
selectSelect dropdown optionselector: string, value: string
hoverHover over elementselector: string

Network​

ToolDescriptionParameters
get_network_logsGet network requestsfilter?: object
get_console_logsGet console messagesfilter?: object
wait_for_requestWait for specific requestpattern: string, timeout?: number

Diagnostics​

ToolDescriptionParameters
check_errorsCheck for JS errors-
get_performanceGet performance metrics-
run_auditRun accessibility/performance audittype: string

Usage Examples​

// Navigate to page
await navigate({ url: "https://example.com" });

// Take screenshot
const screenshot = await screenshot({ full_page: true });

Check for Errors​

// Check JavaScript errors
const errors = await check_errors();
console.log(errors);
// Output: { errors: [{ message: "...", stack: "..." }] }

Run Accessibility Audit​

// Run WCAG audit
const audit = await run_audit({ type: "accessibility" });
console.log(audit);
// Output: { violations: [...], passes: [...], score: 85 }

Query DOM​

// Get all links
const links = await query_selector_all({ selector: "a" });

// Get specific element text
const title = await get_text({ selector: "h1" });

Daemon Integration​

The agnt MCP server connects to the agnt daemon for:

  • Session management
  • Proxy routing
  • Notification forwarding

Starting the Daemon​

# Start daemon
agnt daemon start

# Check status
agnt daemon status

# Stop daemon
agnt daemon stop

Response Format​

All tools return responses in this format:

{
  "success": true,
  "data": { ... },
  "error": null
}

On error:

{
  "success": false,
  "data": null,
  "error": {
    "code": "ELEMENT_NOT_FOUND",
    "message": "Element not found: selector '#missing'"
  }
}

Error Codes​

CodeDescription
NAVIGATION_FAILEDPage failed to load
ELEMENT_NOT_FOUNDSelector didn't match any element
TIMEOUTOperation timed out
DAEMON_NOT_CONNECTEDNot connected to agnt daemon
INVALID_URLURL is malformed

Version History​

VersionChanges
0.7.12Cross-platform improvements
0.7.11Added audit tools
0.7.10Network monitoring