MCP Server

Grroxy exposes its tools as an MCP (Model Context Protocol) server, letting AI agents interact with your proxy data directly.

What is MCP?

MCP is an open protocol that lets AI tools connect to external data sources. With Grroxy's MCP server, AI agents can search requests, send payloads, and read captured data programmatically.

Starting the MCP Server

The MCP server runs alongside Grroxy. Access it at:

SSE endpoint: /mcp/sse
Message endpoint: /mcp/message
Health check: /mcp/health
List tools: /mcp/listtools

Available Tools

Utility

Tool	Description
`grroxyStatus`	Check if Grroxy is active

Data

Tool	Description
`getRequestResponseFromID`	Get the request and response for an active ID
`hostPrintSitemap`	Get the sitemap for a host
`hostPrintRowsInDetails`	Get the table for a host
`listHosts`	List all hosts with technologies and labels
`getHostInfo`	Get detailed info for a host (technologies, labels, notes)
`getNoteForHost`	Get the note for a host
`setNoteForHost`	Set the note for a host
`modifyHostLabels`	Add or remove labels from a host
`modifyHostNotes`	Add, update, or remove notes for a host

Action

Tool	Description
`sendRequest`	Send a raw HTTP request

Intercept

Tool	Description
`interceptToggle`	Enable or disable request/response interception on a proxy
`interceptPrintRowsInDetails`	List intercepted requests/responses with full metadata
`interceptGetRawRequestAndResponse`	Get raw HTTP request and response for an intercepted record
`interceptAction`	Forward or drop a pending intercept

Proxy

Tool	Description
`proxyList`	List all running proxy instances
`proxyStart`	Start a new proxy with optional browser (chrome, firefox)
`proxyStop`	Stop a proxy by ID, or stop all
`proxyScreenshot`	Capture a screenshot from attached Chrome browser
`proxyClick`	Click an element on the page
`proxyElements`	Extract interactive elements (buttons, links, inputs) with CSS selectors
`proxyType`	Type text into a form field
`proxyEval`	Execute JavaScript in the page context
`proxyWaitForSelector`	Wait for a CSS selector to become visible

Chrome Tabs

Tool	Description
`proxyListTabs`	List all open tabs in Chrome
`proxyOpenTab`	Open a new tab
`proxyNavigateTab`	Navigate a tab to a URL
`proxyActivateTab`	Switch focus to a specific tab
`proxyCloseTab`	Close a specific tab
`proxyReloadTab`	Reload a tab, optionally bypassing cache
`proxyGoBack`	Navigate back in browser history
`proxyGoForward`	Navigate forward in browser history

Connecting Claude Code

Grroxy has a built-in setup for Claude Code:

# The setup endpoint configures Claude Code automatically
curl http://127.0.0.1:8090/mcp/setup/claude

Or configure manually in your Claude Code MCP settings to point to Grroxy's MCP endpoint.

Connecting Other AI Agents

Any MCP-compatible client can connect to Grroxy. Point your client's MCP configuration to:

http://127.0.0.1:8090/mcp/sse

Use Cases

Automated vulnerability scanning — let AI agents crawl and test endpoints
Data analysis — query captured traffic with natural language
Report generation — AI reads your findings and generates reports
Payload generation — AI creates context-aware test payloads based on captured data