ProxyPin MCP Server

Instructions

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])