list_requests
Retrieve and analyze captured HTTP traffic from ProxyPin to inspect recent requests, filter by domain, method, or status, and support API analysis.
Instructions
List recent HTTP requests captured by ProxyPin.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | ||
| detail | No | summary | |
| domain | No | ||
| method | No | ||
| status | No |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |
Implementation Reference
- src/proxypin_mcp/server.py:33-57 (handler)The 'list_requests' tool is defined here as an MCP tool handler using the FastMCP decorator. It performs input validation, fetches requests from the reader, and formats the output as JSON.
@mcp.tool() def list_requests( limit: int = 20, detail: str = "summary", domain: str | None = None, method: str | None = None, status: int | None = None, ) -> str: """List recent HTTP requests captured by ProxyPin.""" normalized_limit = _bounded_limit(limit, default=20, maximum=100) normalized_detail = detail.lower().strip() detail_level = ( DetailLevel(normalized_detail) if normalized_detail in VALID_DETAILS else DetailLevel.SUMMARY ) requests = reader.get_requests( limit=normalized_limit, detail_level=detail_level, domain=domain, method=method, status_code=status, ) return _json_response([request.model_dump() for request in requests])