get_proxy_history
Retrieve captured HTTP/HTTPS traffic from Burp Proxy, filter by host, method, or status code, and limit results for targeted analysis.
Instructions
Get HTTP/HTTPS traffic captured by Burp Proxy
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| host | No | Filter by host (optional) | |
| limit | No | Maximum number of items to return (default: 10) | |
| method | No | Filter by HTTP method (optional) | |
| status_code | No | Filter by HTTP status code (optional) |
Implementation Reference
- src/index.ts:593-635 (handler)The handler for the 'get_proxy_history' tool. It extracts optional filter parameters (host, method, status_code, limit) from the arguments, filters the mockProxyHistory array accordingly, and returns a JSON-formatted text content with summary of matching items including id, host, method, url, status_code, time, size, and mime_type.
case "get_proxy_history": { const host = request.params.arguments?.host as string | undefined; const method = request.params.arguments?.method as string | undefined; const statusCode = request.params.arguments?.status_code as number | undefined; const limit = Number(request.params.arguments?.limit || 10); let history = [...mockProxyHistory]; // Apply filters if (host) { history = history.filter(item => item.host.includes(host)); } if (method) { history = history.filter(item => item.method === method.toUpperCase()); } if (statusCode) { history = history.filter(item => item.statusCode === statusCode); } // Apply limit history = history.slice(0, limit); return { content: [{ type: "text", text: JSON.stringify({ total_items: history.length, items: history.map(item => ({ id: item.id, host: item.host, method: item.method, url: item.url, status_code: item.statusCode, time: item.time, size: item.size, mime_type: item.mimeType })) }, null, 2) }] }; } - src/index.ts:435-458 (registration)Registration of the 'get_proxy_history' tool in the ListToolsRequestSchema handler, including its name, description, and inputSchema defining optional parameters for filtering proxy history.
name: "get_proxy_history", description: "Get HTTP/HTTPS traffic captured by Burp Proxy", inputSchema: { type: "object", properties: { host: { type: "string", description: "Filter by host (optional)" }, method: { type: "string", description: "Filter by HTTP method (optional)" }, status_code: { type: "number", description: "Filter by HTTP status code (optional)" }, limit: { type: "number", description: "Maximum number of items to return (default: 10)" } } } }, - src/index.ts:59-70 (schema)TypeScript interface defining the structure of ProxyHistoryItem, used for typing the mock data and implicitly the tool's data handling.
interface ProxyHistoryItem { id: string; host: string; method: string; url: string; statusCode: number; request: string; response: string; time: string; size: number; mimeType: string; }