Charles MCP Server

Instructions

Implementation Reference

• charles_mcp/tools/history.py:249-259 (handler)

  The implementation of the get_recording_snapshot tool, which uses the history_service to retrieve a snapshot result.

  async def get_recording_snapshot(
      ctx: ToolContext,
      path: Optional[str] = None,
  ) -> RecordingSnapshotResult:
      """Load a saved recording snapshot. This tool never reads the live Charles session."""
      deps = get_tool_dependencies(ctx)
      try:
          return await deps.history_service.get_snapshot_result(path)
      except Exception as exc:
          raise ValueError(str(exc)) from exc